Invoke-AzSynapseDataFlowDebugSessionCommand
Invoque la acción de depuración en la sesión de depuración del flujo de datos.
Sintaxis
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
Este comando ejecuta la vista previa de datos, la vista previa de estadísticas y la vista previa de expresiones para diferentes flujos de flujo de datos en la sesión de depuración. La secuencia de comandos de PowerShell para el flujo de trabajo de depuración de flujo de datos debe ser:
Start-AzSynapseDataFlowDebugSession
Add-AzSynapseDataFlowDebugSessionPackage
Invoke-AzSynapseDataFlowDebugSessionCommand (repita este paso para distintos comandos o destinos, o repita el paso 2-3 para cambiar el archivo de paquete).
Stop-AzSynapseDataFlowDebugSession
Ejemplos
Ejemplo 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]]
}
En este ejemplo se invoca el comando de vista previa de datos para la sesión de depuración "3afb278e-ac5f-469f-a0b6-2f04c3ab59bc" en el área de trabajo de Synapse "ContosoWorkspace" y, a continuación, convierte la salida JSON en una cadena legible.
Ejemplo 2
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Invoke-AzSynapseDataFlowDebugSessionCommand -Command executePreviewQuery -SessionId 3afb278e-ac5f-469f-a0b6-2f04c3ab59bc -StreamName source1 -RowLimit 100
En este ejemplo se invoca el comando de vista previa de datos para la sesión de depuración "3afb278e-ac5f-469f-a0b6-2f04c3ab59bc" en el área de trabajo de Synapse "ContosoWorkspace" a través de la canalización.
Parámetros
-AsJob
Ejecución del cmdlet en segundo plano
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Column
Lista de columnas de la vista previa de estadísticas de flujo de datos.
Tipo: | List<T>[String] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Command
Comando de depuración del flujo de datos. Las opcionales son executePreviewQuery, executeStatisticsQuery y executeExpressionQuery.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Tipo: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Expression
Expresión para la vista previa de expresiones de flujo de datos.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RowLimit
Límite de filas para la vista previa de datos de flujo de datos.
Tipo: | Nullable<T>[Int32] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SessionId
Identificador de la sesión de depuración del flujo de datos de Synapse.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-StreamName
Nombre del flujo de datos para la depuración.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WorkspaceName
Nombre del área de trabajo de Synapse.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WorkspaceObject
objeto de entrada del área de trabajo, que normalmente se pasa a través de la canalización.
Tipo: | PSSynapseWorkspace |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |