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

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

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

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

   

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

   

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

   

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

   

5. 新しい変数を追加したら、変数を構成し、[名前]、[型]、[既定値] セットを設定できます。 メモを追加することもできます。

   

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

   

   

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

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

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

   

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

   

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

   

   

   

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

   

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

   

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

   

   

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

   

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

   

   

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

   

既知の制限事項

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

• 変数ライブラリは、データ型としてブール値、Datetime、Guid、整数、数値、および文字列をサポートしています。 パイプラインでは、ブール値は Bool 型、Datetime は文字列型、Guid は文字列型、整数は Int 型、文字列は String 型として表示されます。 パイプラインでは、数値の種類はサポートされていません。
• 外部接続のパラメーター化は、パイプラインと統合された変数ライブラリでサポートされています。 ただし、[設定] | から接続の GUID を検索する必要があります。接続とゲートウェイを管理します。 接続名の横にある [設定] を選択すると、接続の GUID が表示されます。

関連コンテンツ

• Data Factory でのパイプライン用 CI/CD
• パイプラインのパラメーター
• Microsoft Fabric の ALM サイクルの一環としての CI/CD プロセスの概要