Fabric で変数の設定アクティビティを使用する

変数の設定アクティビティを使用して、Microsoft Fabric 用の Data Factory のパイプライン内に定義された文字列、ブール、または配列の型の既存の変数の値を設定したり、または変数の設定アクティビティを使用してパイプラインの戻り値を設定したりします。 パイプライン変数は、出力された結果やデータを追跡するために使用できます。また後にパイプラインを実行する際や、これを結果として返す際には、この変数を再度使用する必要があります。

変数の設定アクティビティの使用シナリオは、要件によって大きく異なる場合があります。 たとえば、以前に返されたデータ内のフィールドの行数または集計値の数が特定の量より大きいか小さい場合に、特定のパスを選択する必要がある場合がありますが、常に必要な他の複数の手順が完了した後で、パイプラインの後で代替パスを選択する必要がある場合があります。 パイプライン変数を使用すると、結果を変数に格納し、後でそれを使用して、変数の値に応じて代替パスを選択できます。 また、変数の設定アクティビティを使用して、1 つ以上の構成変数で構成されるパイプラインの戻り値を設定することもできます。 これは、パイプラインの出力を使用する後続のパイプラインで使用できます。

前提条件

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

• アクティブなサブスクリプションが含まれるテナント アカウント。 無料でアカウントを作成できます。
• ワークスペースが作成されている。

UI を使用してパイプラインに変数の設定アクティビティを追加する

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

アクティビティの作成

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

2. パイプラインの [アクティビティ] ペイン内で [変数の設定] を検索し、それを選択してパイプライン キャンバスに追加します。 ウィンドウ サイズが直接表示するのに十分な大きさでない場合は、ツール バーの右端にあるドロップダウン + ボタンを使用して、使用可能なアクティビティの一覧を展開する必要がある場合があります。

   

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

   

[全般設定] タブを構成するには、全般設定のガイダンスを参照してください。

変数の設定の設定

[設定] タブでは、パイプライン変数を選択することも、パイプラインの戻り値を直接指定することもできます。 この例では、文字列データ型で値が "Some value" の MyVariable という 1 つの戻り値を示しています。

[+ 新規] ボタンを使用してパイプラインの戻り値に複数の値を追加できます (または [削除] ボタンで削除します)。 同様に、パイプライン変数を設定する場合は、[名前] ドロップダウン ボックスから以前に定義した変数を選択するか、[+ 新規] ボタンを使用して新しいものを追加できます。 変数の設定アクティビティとは独立したパイプライン変数を作成する場合は、パイプライン キャンバスで背景を選択し (パイプラインのプロパティ ページを表示し)、パイプライン設定の [変数] タブを使用して作成します。 その後、[変数の設定] の [設定] で [パイプライン変数] を選択するときに、それらをドロップダウン リストから選択できます。

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

通常、変数の設定は他のアクティビティと一緒に使用されますが、そのまま直接実行することもできます。 パイプラインをここで実行するには、パイプライン エディターの上部にある [ホーム] タブに切り替え、[保存] ボタンを選んでパイプラインを保存します。 [実行] を選択して直接実行するか、[スケジュール] を選択してスケジュールを設定します。 ここで実行履歴を表示したり、他の設定を構成したりすることもできます。

関連するコンテンツ

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