Delen via


Invoke-AzSynapseDataFlowDebugSessionCommand

Roep de foutopsporingsactie aan in de foutopsporingssessie voor gegevensstromen.

Syntax

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>]

Description

Met deze opdracht wordt de preview-versie/preview van statistieken/expressies uitgevoerd voor verschillende stromen gegevensstromen in de foutopsporingssessie. De PowerShell-opdrachtreeks voor foutopsporingswerkstroom voor gegevensstromen moet het volgende zijn:

Start-AzSynapseDataFlowDebugSession
Add-AzSynapseDataFlowDebugSessionPackage
Invoke-AzSynapseDataFlowDebugSessionCommand (herhaal deze stap voor verschillende opdrachten/doelen of herhaal stap 2-3 om het pakketbestand te wijzigen)
Stop-AzSynapseDataFlowDebugSession

Voorbeelden

Voorbeeld 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]]
    }

In dit voorbeeld wordt de opdracht data preview aangeroepen voor foutopsporingssessie '3afb278e-ac5f-469f-a0b6-2f04c3ab59bc' in de Synapse-werkruimte 'ContosoWorkspace' en converteert u de JSON-uitvoer naar een leesbare tekenreeks.

Voorbeeld 2

$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Invoke-AzSynapseDataFlowDebugSessionCommand -Command executePreviewQuery -SessionId 3afb278e-ac5f-469f-a0b6-2f04c3ab59bc -StreamName source1 -RowLimit 100

In dit voorbeeld wordt de opdracht gegevensvoorbeeld aangeroepen voor foutopsporingssessie '3afb278e-ac5f-469f-a0b6-2f04c3ab59bc' in de Synapse-werkruimte 'ContosoWorkspace' via pijplijn.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Column

De kolomlijst voor de preview-versie van gegevensstroomstatistieken.

Type:List<T>[String]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Command

De opdracht voor foutopsporing van gegevensstromen. Optionele opties zijn executePreviewQuery, executeStatisticsQuery en executeExpressionQuery.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Expression

De expressie voor de voorbeeldweergave van de gegevensstroomexpressie.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-RowLimit

De rijlimiet voor gegevensstroomgegevensvoorbeeld.

Type:Nullable<T>[Int32]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionId

Id voor foutopsporingssessie voor Synapse-gegevensstromen.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-StreamName

De stroomnaam van de gegevensstroom voor foutopsporing.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceName

Naam van Synapse-werkruimte.

Type:String
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceObject

werkruimte-invoerobject, meestal doorgegeven via de pijplijn.

Type:PSSynapseWorkspace
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

PSSynapseWorkspace

Uitvoerwaarden

PSDataFlowDebugCommandResponse