Azure Data Factory と Azure Synapse Analytics パイプラインの Validation アクティビティ
適用対象:
Azure Data Factory Azure Synapse Analytics
ヒント
企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。
パイプラインで検証を使用すると、アタッチされたデータセット参照が存在していて、指定された条件を満たしていること、またはタイムアウトに達していることを検証した後でのみ、パイプラインが実行を継続することを確認できます。
UI を使用して Validation アクティビティを作成する
パイプライン内で Validation アクティビティを使用するには、次の手順を実行します。
- パイプラインのアクティビティ ウィンドウ内で Validation を検索し、Validation アクティビティをパイプライン キャンバスにドラッグします。
- キャンバス上で新しい Validation アクティビティを選択し (まだ選択されていない場合)、その [設定] タブを選択して、詳細を編集します。
- データセットを選択するか、[新規] ボタンを選択して新しいデータセットを定義します。 上記の区切りテキストの例のようなファイル ベースのデータセットの場合、特定のファイルまたはフォルダーを選択できます。 フォルダーを選択すると、Validation アクティビティを使用して、フォルダー内の子項目が存在するかどうかの検証を無視したり、子項目が存在するかどうかの確認を要求したりすることができます。
- Validation アクティビティの出力は、他のアクティビティへの入力として使用し、動的な式を使って、こうしたアクティビティ内でそのプロパティを参照することができます。
構文
{
"name": "Validation_Activity",
"type": "Validation",
"typeProperties": {
"dataset": {
"referenceName": "Storage_File",
"type": "DatasetReference"
},
"timeout": "0.12:00:00",
"sleep": 10,
"minimumSize": 20
}
},
{
"name": "Validation_Activity_Folder",
"type": "Validation",
"typeProperties": {
"dataset": {
"referenceName": "Storage_Folder",
"type": "DatasetReference"
},
"timeout": "0.12:00:00",
"sleep": 10,
"childItems": true
}
}
型のプロパティ
| プロパティ | 説明 | 使用できる値 | 必須 |
|---|---|---|---|
| name | '検証' アクティビティの名前 | String | はい |
| type | Validation に設定する必要があります。 | String | はい |
| dataset | アクティビティは、このデータセット参照が存在していて指定された条件を満たしていること、またはタイムアウトに達していることを検証するまで、実行をブロックします。 提供するデータセットは、"MinimumSize" または "ChildItems" プロパティをサポートする必要があります。 | データセット参照 | はい |
| timeout | アクティビティの実行に関するタイムアウトを指定します。 値が指定されていない場合は、既定値の 12 時間 ("0.12:00:00") が使用されます。 形式は d.hh:mm:ss です | String | いいえ |
| sleep | 検証の試行間の遅延 (秒単位)。 値が指定されていない場合は、既定値の 10 秒が使用されます。 | Integer | いいえ |
| childItems | フォルダーに子項目があるかどうかチェックします。 true に設定すると、フォルダーが存在していること、およびそこに項目があることが検証されます。 フォルダー内に少なくとも 1 つの項目が存在するまで、またはタイムアウト値に達するまでブロックします。false に設定すると、フォルダーが存在し、それが空であることが検証されます。 フォルダーが空になるまで、またはタイムアウト値に達するまで、ブロックします。 値が指定されていない場合、フォルダーが存在するかタイムアウトに達するまで、アクティビティはブロックされます。 | ブール型 | いいえ |
| minimumSize | ファイルの最小サイズ (バイト単位)。 値が指定されていない場合は、既定値の 0 バイトが使用されます | Integer | いいえ |
関連するコンテンツ
サポートされている他の制御フロー アクティビティを参照してください。