Until アクティビティを使用して実行フローを制御する

Until アクティビティは、do-until ループ構造がプログラミング言語で提供するのと同じ機能を提供します。 アクティビティに関連付けられている条件が true に評価されるまで、ループ内で一連のアクティビティを実行します。 内部アクティビティが失敗した場合、Until アクティビティは停止しません。 until アクティビティのタイムアウト値を指定できます。

前提 条件

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

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

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

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

アクティビティを作成する

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

2. パイプライン アクティビティ ペインで Until を検索し、それを選択してパイプライン キャンバスに追加します。

   

3. キャンバスで新しい Until アクティビティがまだ選択されていない場合は選択します。

   

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

パイプライン変数を追加する

この簡単な例では、パイプライン変数の値をテストします。 パイプライン エディター キャンバスの背景を選択し、変数 タブを選択し、値 0 の testVariable という新しい整数型変数を追加します。

Until アクティビティの設定

1. パイプライン キャンバスで Until アクティビティをもう一度選択し、[設定] タブを選択します。[式] フィールドを選択し、[動的コンテンツ の追加]選択し、次の式を指定します:@equals(variables('TestVariable'), 1)。

   

2. [アクティビティ ] タブを選択し、鉛筆アイコンを選択してアクティビティを編集/追加するか、パイプライン エディター キャンバスの Until アクティビティの + アイコンを選択します。 変数の設定 アクティビティを探し、それを選択して Until アクティビティの子アクティビティの一覧に追加します。

   

3. パイプライン エディター キャンバスの Until アクティビティの [アクティビティ] ペインに表示される新しく追加された変数の設定アクティビティを選択し、アクティビティのプロパティ ウィンドウから [設定] タブを選択します。 変数の種類で、パイプライン変数を選択し、ドロップダウンリストから以前に作成した TestVariable を選択します。 この例では、1の 値 を指定します。 複数のアクティビティを反復処理する場合、パイプラインによって実行される集計とクリーンアップの作業により、ループの終了に遅延が生じる可能性があります。

   

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

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

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

この単純なパイプラインは、Until アクティビティの子アクティビティを 1 回実行し、パイプライン変数の値を 0 から 1 に変更します。その後、Until 式は true に評価され、終了します。

関連コンテンツ

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