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

Data Factory for Microsoft Fabric のパイプラインで定義されている String、Bool、または Array 型の既存の変数の値を設定するには、変数の設定アクティビティを使用するか、変数の設定アクティビティを使用してパイプラインの戻り値を設定します。 パイプライン変数を使用すると、発生した結果やデータを追跡し、パイプラインの実行中に後でもう一度使用する必要があります。また、結果として返すこともできます。

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

前提 条件

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

• アクティブなサブスクリプションを持つテナント アカウント。 無料用のアカウントを作成します。
• ワークスペースが作成されます。

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

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

アクティビティの作成

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

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

   

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

   

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

変数の設定

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

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

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

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

関連コンテンツ

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