Invoke-AzDataFactoryV2DataFlowDebugSessionCommand

データ フロー デバッグ セッションでデバッグ アクションを呼び出します。

構文

Invoke-AzDataFactoryV2DataFlowDebugSessionCommand
      [-SessionId] <String>
      [-Command] <String>
      [-StreamName] <String>
      [[-RowLimit] <Int32>]
      [[-Expression] <String>]
      [[-Columns] <System.Collections.Generic.List`1[System.String]>]
      [-AsJob]
      [-ResourceGroupName] <String>
      [-DataFactoryName] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzDataFactoryV2DataFlowDebugSessionCommand
      [-SessionId] <String>
      [-Command] <String>
      [-StreamName] <String>
      [[-RowLimit] <Int32>]
      [[-Expression] <String>]
      [[-Columns] <System.Collections.Generic.List`1[System.String]>]
      [-AsJob]
      [-DataFactory] <PSDataFactory>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Invoke-AzDataFactoryV2DataFlowDebugSessionCommand
      [-SessionId] <String>
      [-Command] <String>
      [-StreamName] <String>
      [[-RowLimit] <Int32>]
      [[-Expression] <String>]
      [[-Columns] <System.Collections.Generic.List`1[System.String]>]
      [-AsJob]
      [-ResourceId] <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドは、デバッグ セッション内のさまざまなデータ フロー ストリームに対してデータ プレビュー/統計プレビュー/式プレビューを実行します。 データ フロー デバッグ ワークフローの PowerShell コマンド シーケンスは次のようになります。

  1. Start-AzDataFactoryV2DataFlowDebugSession
  2. Add-AzDataFactoryV2DataFlowDebugSessionPackage
  3. Invoke-AzDataFactoryV2DataFlowDebugSessionCommand (異なるコマンド/ターゲットに対してこの手順を繰り返すか、パッケージ ファイルを変更するために手順 2 から 3 を繰り返します)
  4. Stop-AzDataFactoryV2DataFlowDebugSession

例 1

$result = Invoke-AzDataFactoryV2DataFlowDebugSessionCommand -ResourceGroupName adf -DataFactoryName WiKiADF -Command executePreviewQuery -SessionId fd76cd0d-8b37-4dc0-a370-3f9d43ac686d -StreamName source1 -RowLimit 100 -AsJob
$result

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Long Running... AzureLongRun... Running       True            localhost            Invoke-AzDataFactoryV2...


(After 2 minutes)

$result

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Long Running... AzureLongRun... Completed     True            localhost            Invoke-AzDataFactoryV2...

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

この例では、データ ファクトリ "WiKiADF" でデバッグ セッション "fd76cd0d-8b37-4dc0-a370-3f9d43ac686d" のデータ プレビュー コマンドを呼び出し、JSON 出力を読み取り可能な文字列に変換します。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行する

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Columns

データ フロー統計プレビューの列の一覧。

Type:List<T>[String]
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Command

データ フロー デバッグ コマンド。 省略可能なオプションは、executePreviewQuery、executeStatisticsQuery、および executeExpressionQuery です。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataFactory

データ ファクトリ オブジェクト。

Type:PSDataFactory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DataFactoryName

データ ファクトリ名。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Expression

データ フロー式プレビューの式。

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソース グループ名。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Azure リソース ID。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RowLimit

データ フロー データ プレビューの行制限。

Type:Nullable<T>[Int32]
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionId

データ フロー デバッグ セッション ID。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StreamName

デバッグ用のデータ フローのストリーム名。

Type:String
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

String

PSDataFactory

出力

PSDataFlowDebugSessionCommandResult

メモ

キーワード: azure, azurerm, arm, リソース, 管理, マネージャー, データ, factoriesKeywords: azure, azurerm, arm, リソース, 管理, マネージャー, データ, ファクトリ