Fail アクティビティを使用して、カスタマイズされたエラー メッセージとエラー コードを使用してパイプラインの実行を失敗させる

パイプラインで意図的にエラーをスローしたい場合があります。 参照アクティビティ が一致するデータを返さない場合や、スクリプト アクティビティの が内部エラーで終了する可能性があります。 理由が何であれ、パイプラインで Fail アクティビティを使用し、エラー メッセージとエラー コードの両方をカスタマイズできるようになりました。

Fail アクティビティを使用するタイミング

Fail アクティビティは、特定の条件に基づいてパイプラインを失敗させる条件付きシナリオでよく使用されます。

• データ検証エラー: データが品質基準を満たしていない場合
• ビジネス ロジック違反: ビジネス ルールが満たされていない場合
• 依存関係チェック: 必要なリソースまたはデータ ソースが使用できない場合
• カスタム エラー処理: 一般的なシステム エラーの代わりに特定のエラー情報を提供する場合

通常、Fail アクティビティは、条件付きロジック (If Condition アクティビティ) を使用して他のアクティビティに接続されるか、エラー条件を生成する可能性があるアクティビティの後に配置されます。

前提 条件

開始するには、次の前提条件を満たす必要があります。

• アクティブな Microsoft Fabric サブスクリプションを持つテナント アカウント。 無料試用版で Fabric を試すことができます。
• ファブリック ワークスペース。

UI を使用してパイプラインに失敗アクティビティを追加する

パイプラインで失敗アクティビティを使用するには、次の手順を実行します。

1. ワークスペースに新しいパイプラインを作成します。

2. パイプライン アクティビティ ペインで失敗アクティビティを検索し、それを選択してパイプライン キャンバスに追加します。 ウィンドウの右端にあるアクティビティ リストを展開する必要がある場合や、ブラウザーのウィンドウ幅に応じて、この画像に示すように、Outlook アイコンの下にテキストのラベルを付けずに圧縮できます。

   

3. まだ選択していない場合は、キャンバスで新しい Fail アクティビティを選択します。

   

   全般 設定 ガイダンスを参照して、全般 設定タブを構成します。

4. [設定] タブを選択し、アクティビティの呼び出し時にパイプラインで報告するカスタム エラー メッセージとエラー コードを指定します。 これらの値は、失敗アクティビティの実行時にパイプラインの実行履歴とログに表示され、パイプラインの失敗の原因となった特定のエラー状態を特定するのに役立ちます。

   

パイプラインを保存して実行またはスケジュールする

通常、失敗アクティビティは他のアクティビティと共に使用されるため、パイプラインに必要な他のアクティビティを構成したら、次の手順を実行します。

パイプライン エディターの上部にある [ ホーム ] タブに切り替え、[保存] ボタンを選択してパイプラインを保存します。 [ 実行 ] を選択して直接実行するか、特定の時間または間隔で実行をスケジュールする スケジュール を設定します。 パイプラインの実行の詳細については、「パイプラインの実行 をスケジュールする」を参照してください。

実行後、パイプラインの実行を監視し、キャンバスの下にある [出力 ] タブから実行履歴を表示できます。

例: 条件付きパイプラインエラー

カスタム条件に基づいてパイプラインを失敗する一般的なパターンを次に示します。

1. If 条件アクティビティを使用してカスタム エラー条件を評価する
2. If 条件の True 分岐に、失敗アクティビティを追加します。
3. 満たされた特定の条件を説明するカスタム エラー メッセージを使用して失敗アクティビティを構成する
4. False ブランチで、通常のパイプライン実行を続行します

このパターンにより、特定のビジネスまたはデータ条件が発生した場合に、意味のあるエラー メッセージでパイプラインが正常に失敗します。

関連コンテンツ

パイプラインの実行を監視する方法