変数ライブラリとパイプラインの統合

変数ライブラリは、Microsoft Fabric の新しい項目の種類です。 変数ライブラリを使用すると、ワークスペース レベルで変数を定義および管理できます。 これらの変数は、パイプライン、ノートブック、lakehouse のショートカットなど、さまざまなワークスペース項目で使用できます。 これにより、構成を管理するための統一された一元化された方法が提供され、ハードコーディングされた値の必要性が減り、CI/CD プロセスが簡素化されます。 さまざまな環境で構成を管理する方が簡単です。

パイプラインで変数ライブラリを使用する方法

  1. ワークスペースに移動し、新しい項目を作成します。

    Fabric ワークスペースに新しい項目を追加する場所が強調表示されているスクリーンショット。

  2. フィルターを使用して変数ライブラリを検索するか、[データの開発] セクションまで下にスクロールします。

    新しい変数ライブラリ項目のフィルターを示すスクリーンショット。

  3. [変数ライブラリ] を選択して、新しい変数ライブラリを作成します。 名前を入力し、[ 作成] を選択します。

    名前が設定され、[作成] ボタンが強調表示されている新しい変数ライブラリ項目を示すスクリーンショット。

  4. 変数ライブラリを作成すると、ホームページにアクセスします。 [+ 新規] を選択して新しい変数を追加します。

    新しい変数ライブラリ項目のスタート ページを示すスクリーンショット。

  5. 新しい変数を追加するときに、変数を構成し、名前、型、既定値を設定できます。 メモを追加することもできます。

    新しい変数に設定する構成を示すスクリーンショット。

  6. 必要に応じて代替値セットを追加します (たとえば、デプロイ パイプライン環境ごとに異なる値)。 名前を設定して [作成] を選択すると、変数の値を編集し、アクティブにする値セットを選択できます。

    変数の新しい値セットを追加する場所を強調表示したスクリーンショット。

    新しい値セットの名前を追加する方法を示すスクリーンショット。

  7. 完了したら、変更を保存します。

    左上隅で強調表示されている [保存] ボタンを示すスクリーンショット。

パイプラインで変数ライブラリ変数を使用する

  1. パイプラインで変数ライブラリ変数を使用するには、新しいパイプラインを作成するか、既存のパイプラインに移動します。

    左上隅の [新しい項目の作成] ボタンが強調表示され、パイプライン項目が強調表示されているスクリーンショット。

  2. パイプラインで、下部のパネルにある変数ライブラリへの参照を作成します。

    パイプライン キャンバスの下部パネルにある [ライブラリ変数] タブと [+新規] ボタンが強調表示されているスクリーンショット。

  3. [+新規] を選択します。 すべての変数ライブラリを表示するポップアップが開きます。 このピッカーを使用して変数ライブラリ変数を選択し、[ OK] を選択します。

    [ライブラリ変数] タブの [+新規] ボタンが強調表示されているスクリーンショット。

    変数ピッカーで選択されているライブラリ変数を示すスクリーンショット。

    新しいライブラリ変数参照の構成セットを示すスクリーンショット。

  4. ライブラリ変数参照を追加したら、パイプライン アクティビティを追加します。 アクティビティ設定で、パラメーター化する設定の [動的コンテンツの追加 ] を選択します。

    ルックアップ アクティビティの設定で強調表示されている動的コンテンツの追加を示すスクリーンショット。

  5. 式ビルダーが開きます。 [ ライブラリ変数] が表示されない場合は、[ 関数 ] の横にある 3 つのドットを選択し、[ ライブラリ変数] を選択します。

    式ビルダーの [関数] の横にある 3 つのドットを示すスクリーンショット。[ライブラリ変数] タブが強調表示されています。

  6. ライブラリ変数参照を選択して、式ビルダーに新しい式を追加します。 次に、[ OK] を 選択して式を追加します。

    式ビルダーに追加するライブラリ変数参照が強調表示されているスクリーンショット。

    式ビルダーの式セットを示すスクリーンショット。

Note

接続参照または項目参照型を使用している場合は、式ビルダーに変数を追加した後、変数プロパティを取得する '.' を追加します。 この手順では、接続 ID、項目 ID、アイテム ワークスペースなどの値を使用できます。

  1. 動的コンテンツがアクティビティ設定に追加されていることがわかります。

    ルックアップ アクティビティの設定で動的コンテンツとして設定された式を示すスクリーンショット。

  2. [データのプレビュー] を選択すると 、データをプレビューできます。 この操作により、ライブラリ変数の値を示す新しいペインが開きます。 [ OK] を 選択して、データのプレビューを取得します。

    プレビュー データ オプションを示すスクリーンショット。

    プレビュー データ ペインを示すスクリーンショット。

  3. 通常どおりにパイプラインを保存して実行します。 渡された値は、変数ライブラリで Active として設定されている値であることがわかります。

    パイプライン キャンバスで強調表示されている [保存と実行] の設定を示すスクリーンショット。

既知の制限事項

Microsoft Fabric の Data Factory のパイプラインでの変数ライブラリの統合には、次の既知の制限事項が適用されます。

  • 変数ライブラリは、データ型としてブール値、Datetime、Guid、整数、数値、および文字列をサポートしています。 パイプラインでは、ブール値は Bool 型、Datetime は String 型、Guid は String 型、整数は Int 型、文字列は String 型として表示されます。 パイプラインでは、数値の種類はサポートされていません。

関連コンテンツ

  • Last updated on