Invoke-AzSynapseDataFlowDebugSessionCommand
Wywołaj akcję debugowania w sesji debugowania przepływu danych.
Składnia
Invoke-AzSynapseDataFlowDebugSessionCommand
-WorkspaceName <String>
-SessionId <String>
-Command <String>
-StreamName <String>
[-RowLimit <Int32>]
[-Expression <String>]
[-Column <System.Collections.Generic.List`1[System.String]>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzSynapseDataFlowDebugSessionCommand
-WorkspaceObject <PSSynapseWorkspace>
-SessionId <String>
-Command <String>
-StreamName <String>
[-RowLimit <Int32>]
[-Expression <String>]
[-Column <System.Collections.Generic.List`1[System.String]>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
To polecenie wykonuje podgląd danych/podgląd statystyk podglądu/wyrażenia dla różnych strumieni przepływu danych w sesji debugowania. Sekwencja poleceń programu PowerShell dla przepływu pracy debugowania przepływu danych powinna być następująca:
Start-AzSynapseDataFlowDebugSession
Add-AzSynapseDataFlowDebugSessionPackage
Invoke-AzSynapseDataFlowDebugSessionCommand (powtórz ten krok dla różnych poleceń/obiektów docelowych lub powtórz krok 2–3, aby zmienić plik pakietu)
Stop-AzSynapseDataFlowDebugSession
Przykłady
Przykład 1
$result = Invoke-AzSynapseDataFlowDebugSessionCommand -WorkspaceName ContosoWorkspace -Command executePreviewQuery -SessionId 3afb278e-ac5f-469f-a0b6-2f04c3ab59bc -StreamName source1 -RowLimit 100 -AsJob
$result | Format-Table -wrap
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Long Running Operation AzureLongRunningJob`1 Completed True localhost Invoke-AzSynapseDataFlowDebugSessionCommand
for 'Invoke-AzSynapseD
ataFlowDebugSessionCommand'
$output = ConvertFrom-Json($result.Output.Data)
$output.output
{
"schema": "output(ResourceAgencyNum as string, PublicName as string)" ,
"data": [["4445679354", "Syrian Refugee Information", 1], ["44456793", "Syrian Refugee Information", 1]]
}
Ten przykład wywołuje polecenie podglądu danych dla sesji debugowania "3afb278e-ac5f-469f-a0b6-2f04c3ab59bc" w obszarze roboczym usługi Synapse "ContosoWorkspace", a następnie przekonwertuj dane wyjściowe JSON na czytelny ciąg.
Przykład 2
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Invoke-AzSynapseDataFlowDebugSessionCommand -Command executePreviewQuery -SessionId 3afb278e-ac5f-469f-a0b6-2f04c3ab59bc -StreamName source1 -RowLimit 100
Ten przykład wywołuje polecenie podglądu danych dla sesji debugowania "3afb278e-ac5f-469f-a0b6-2f04c3ab59bc" w obszarze roboczym usługi Synapse "ContosoWorkspace" za pośrednictwem potoku.
Parametry
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Column
Lista kolumn dla podglądu statystyk przepływu danych.
Typ: | List<T>[String] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Command
Polecenie debugowania przepływu danych. Opcjonalne są executePreviewQuery, executeStatisticsQuery i executeExpressionQuery.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Expression
Wyrażenie dla wyrażenia przepływu danych w wersji zapoznawczej.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RowLimit
Limit wierszy dla podglądu danych przepływu danych.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SessionId
Identyfikator sesji debugowania przepływu danych usługi Synapse.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-StreamName
Nazwa strumienia przepływu danych do debugowania.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WorkspaceName
Nazwa obszaru roboczego usługi Synapse.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WorkspaceObject
obiekt wejściowy obszaru roboczego, zwykle przekazywany przez potok.
Typ: | PSSynapseWorkspace |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |