Invoke-AzSynapseDataFlowDebugSessionCommand

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

此命令针对调试会话中数据流的不同流执行数据预览/统计信息预览/表达式预览。 数据流调试工作流的 PowerShell 命令序列应为：

Start-AzSynapseDataFlowDebugSession Add-AzSynapseDataFlowDebugSessionPackage Invoke-AzSynapseDataFlowDebugSessionCommand（针对不同的命令/目标重复此步骤，或重复步骤 2-3 以更改包文件）Stop-AzSynapseDataFlowDebugSession

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

此示例在 Synapse 工作区“ContosoWorkspace”中调用调试会话“3afb278e-ac5f-469f-a0b6-2f04c3ab59bc”的数据预览命令，然后将 JSON 输出转换为可读字符串。

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

此示例通过管道调用 Synapse 工作区“ContosoWorkspace”中调试会话“3afb278e-ac5f-469f-a0b6-2f04c3ab59bc”的数据预览命令。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。