変数ライブラリを使用する方法について説明します - Microsoft Fabric

このチュートリアルでは、Microsoft Fabric パイプラインで動的コンテンツを使用する方法について説明します。変数ライブラリ項目を作成して変数を追加すると、デプロイパイプラインのさまざまなステージの値を自動化できます。このチュートリアルでは、あるレイクハウスから別のレイクハウスにデータをコピーします。次に、変数ライブラリを使用して、コピーアクティビティのソースとコピー先の値を設定します。

このチュートリアルでは、次の操作を行います。

変数ライブラリを作成します。
ライブラリに変数を追加します。
変数の追加の値セットを定義します。
ワークスペース内の別の項目（例: パイプライン）で変数を利用します。
Git リポジトリ内の変数を編集します。
デプロイパイプラインを作成し、変数ライブラリをデプロイします。
デプロイパイプラインのターゲットステージで設定されたアクティブな値を変更します。
変数の値が各ステージで設定されたアクティブな値に準拠していることを示します。

次の図は、このチュートリアルのワークスペースレイアウトを示しています。

前提条件

アクティブなサブスクリプションが含まれる Fabric テナントアカウント。無料でアカウントを作成できます。
管理ポータルから、次のテナントスイッチが有効になります。
- ユーザーは Fabric 項目を作成できる
テナント管理者、容量管理者、またはワークスペース管理者は、組織の設定に応じて、これらのスイッチを有効にすることができます。

Stage LHs ワークスペース、サンプルデータを含む lakehouse SourceLH_Stage、パイプラインPipeline_Stage作成する

最初に、最初のステージングデータとして使用するワークスペースと lakehouse を作成します。

Power BI に移動します。
サイドバーで[ワークスペース]を選択 します。
ワークスペースを作成します。 それを Stage LHs と呼びます。
レイクハウスを作成します。
1. ワークスペースの上部にある [ 新しい項目] を選択します。
2. [ データの格納] で、[ Lakehouse] を選択します。
3. SourceLH_Stage名前を入力し、[作成] を選択します。
パイプラインを作成します。
1. レイクハウスで、[ 新しいパイプライン] を選択します。
2. Pipeline_Stage名前を入力し、[作成] を選択します。
3. [データを Lakehouse にコピーする] ウィザードの [データソースの選択] ページで、[サンプルデータ] を選択します。
4. [ 祝日] を選択します。
5. サンプルデータの読み込みが完了したら、[ 次へ] を選択します。
6. [ データ変換先に接続] ページで、[ 次へ] を選択します。
7. [ 確認と保存 ] ページで、[ 保存と実行] を選択します。

[変数] ワークスペースを使用してソース LHs を作成する

次に、作業を行うワークスペースを作成し、変数ライブラリで使用します。

Power BI に移動します。
サイドバーで[ワークスペース]を選択 します。
ワークスペースを作成します。変数を 使用してソース LHs を呼び出します。

SourceLH_Dev、SourceLH_Test、SourceLH_Prodのレイクハウスを作成する

次に、変数ライブラリで使用する 3 つのレイクハウスを作成します。

最初のレイクハウスを作成します。
1. サイドバーで、[ 変数を含むソース LHs] ワークスペースを 選択します。
2. 新しい項目を選択します。
3. [ データの格納] で、[ Lakehouse] を選択します。
4. SourceLH_Dev名前を入力し、[作成] を選択します。
前の手順に従って、2 つ目のレイクハウスを作成します。 SourceLH_Test名前を付けます。
上記の手順に従って、3 番目のレイクハウスを作成します。 SourceLH_Prod名前を付けます。
サイドバーで、[ 変数を含むソース LHs ] ワークスペースを選択し、新しく作成されたすべてのレイクハウスが含まれていることを確認します。

lakehouses のワークスペース ID とオブジェクト ID を取得する

これらの手順では、変数ライブラリで使用する一意の識別子を取得します。

Power BI のサイドバーで、Stage LHs ワークスペースを選択します。
ワークスペースで、 SourceLH_Stage lakehouse を選択します。
URL にワークスペース ID と lakehouse オブジェクト ID をコピーします。
[変数を含むソース LHs] ワークスペースの SourceLH_Dev と SourceLH_Test lakehouse に対して、上記の手順を繰り返します。

変数を含む変数ライブラリを作成する

次に、変数ライブラリを作成します。

[ 変数を含むソース LHs] ワークスペースで 、[ 新しい項目] を選択します。
[ データの開発] で**[変数ライブラリ]**を選択します。
ライブラリ WS 変数に名前を付け、[ 作成] を選択します。
[新しい変数] を選択します。

次の変数を作成します。

名前	タイプ	既定値の設定
`Source_LH`	String	<SourceLH_Stage lakehouse の GUID>
`Source_WSID`	String	<SourceLH_Stage ワークスペースの GUID>
`Destination_LH`	String	<SourceLH_Dev lakehouse の GUID>
`Destination_WSID`	String	<SourceLH_Dev ワークスペースの GUID>
`SourceTable_Name`	String	`Processed`
`DestinationTable_Name`	String	`DevCopiedData`

保存を選択します。

代替値セットを作成する

次の手順では、変数ライブラリに代替値セットを追加します。

最初の値セットを作成します。

WS 変数変数ライブラリで、[値セットの追加] を選択します。
名前として 「Test VS 」と入力し、[ 作成] を選択します。

次の変数を作成します。

名前	タイプ	既定値の設定
`Source_LH`	String	<SourceLH_Dev lakehouse の GUID>
`Source_WSID`	String	<SourceLH_Dev ワークスペースの GUID>
`Destination_LH`	String	<SourceLH_Test lakehouse の GUID>
`Destination_WSID`	String	<SourceLH_Test ワークスペースの GUID>
`SourceTable_Name`	String	`DevCopiedData`
`DestinationTable_Name`	String	`TestCopiedData`

>] を選択します。

2 番目の値セットを作成します。

[ 値セットの追加] を選択します。
名前 として「Prod VS 」と入力し、[ 作成] を選択します。

次の変数を作成します。

名前	タイプ	既定値の設定
`Source_LH`	String	<SourceLH_Test lakehouse の GUID>
`Source_WSID`	String	<SourceLH_Test ワークスペースの GUID>
`Destination_LH`	String	<SourceLH_Prod lakehouse の GUID>
`Destination_WSID`	String	<SourceLH_Prod ワークスペースの GUID>
`SourceTable_Name`	String	`TestCopiedData`
`DestinationTable_Name`	String	`ProdCopiedData`

>] を選択します。

Pipeline_Deploy パイプラインを作成し、変数を宣言する

これらの手順では、パイプラインを作成し、変数を宣言します。

[ 変数を含むソース LHs] ワークスペースで 、[ 新しい項目] を選択します。
[ データの取得] で、[パイプライン] を選択 します。
Pipeline_Deploy名前を入力し、[作成] を選択します。
[データのコピー] を選択>キャンバスに追加します。
フォーカスが [データのコピー] からオフになるようにキャンバスを選択します。
**[ライブラリ変数]** を選択します。

[ 新規] を選択し、次の変数を追加します。

名前	図書館	変数名	タイプ
`SourceLH`	WS 変数	`Source_LH`	String
`SourceWSID`	WS 変数	`Source_WSID`	String
`DestinationLH`	WS 変数	`Destination_LH`	String
`DestinationWSID`	WS 変数	`Destination_WSID`	String
`SourceTableName`	WS 変数	`SourceTable_Name`	String
`DestinationTableName`	WS 変数	`DestinationTable_Name`	String

保存を選択します。

Pipeline_Deploy パイプラインのソース接続を構成する

これらの手順では、パイプラインのソース接続を構成します。

[ ソース LHs と変数 ] ワークスペースで、 Pipeline_Deployに移動します。
キャンバスで、[データの コピー ] を選択して、データの コピーにフォーカスを合わせるようにします。
[ソース] を選択します。
SourceLH を構成します。
1. [ソース>接続] で、[動的コンテンツの追加] を選択します。
2. 省略記号 (...) を選択し、**[ライブラリ変数]** を選択します。
3. [SourceLH] を選択します。ボックスに @pipeline().libraryVariables.SourceLHが設定されます。 [OK] を選択.
SourceWSID の構成:
1. [ ソース>ワークスペース ID] で、[ 動的コンテンツの追加] を選択します。
2. 省略記号 (...) を選択し、**[ライブラリ変数]** を選択します。
3. SourceWSID を選択します。ボックスに @pipeline().libraryVariables.SourceWSIDが設定されます。 [OK] を選択.
SourceTableName の構成:
1. [ ソース>テーブル] で、[ 手動で入力] を選択し、[ テーブル名] を選択して、[ 動的コンテンツの追加] を選択します。
2. 省略記号 (...) を選択し、**[ライブラリ変数]** を選択します。
3. SourceTableName を選択します。ボックスに @pipeline().libraryVariables.SourceTableNameが設定されます。 [OK] を選択.
ソース接続が設定されたので、テストできます。 [ データのプレビュー] を選択し、ポップアップで [OK] を選択します 。データが設定されたら、データプレビューを閉じます。

Pipeline_Deploy パイプラインの宛先接続を構成する

次の手順では、パイプラインの宛先接続を構成します。

[ ソース LHs と変数 ] ワークスペースで、 Pipeline_Deployに移動します。
キャンバスで、[データの コピー ] を選択して、データの コピーにフォーカスを合わせるようにします。
[宛先] を選択します。
SourceLH を構成します。
1. [ 変換先>接続] で、[ 動的コンテンツの追加] を選択します。
2. 省略記号 (...) を選択し、**[ライブラリ変数]** を選択します。
3. [SourceLH] を選択します。ボックスに @pipeline().libraryVariables.DestinationLHが設定されます。 [OK] を選択.
DestinationWSID の構成:
1. [ 宛先>ワークスペース ID] で、[ 動的コンテンツの追加] を選択します。
2. 省略記号 (...) を選択し、**[ライブラリ変数]** を選択します。
3. DestinationWSID を選択します。ボックスに @pipeline().libraryVariables.DestinationWSIDが設定されます。 [OK] を選択.
DestinationTableName の構成:
1. [ 変換先>テーブル] で、[ 手動で入力] を選択し、[ テーブル名] を選択して、[ 動的コンテンツの追加] を選択します。
2. 省略記号 (...) を選択し、**[ライブラリ変数]** を選択します。
3. DestinationTableName を選択します。ボックスに @pipeline().libraryVariables.DestinationTableNameが設定されます。 [OK] を選択.
宛先接続が設定されたので、パイプラインを保存して [ 実行] を選択します。正常に実行されたことを確認します。

デプロイパイプラインを作成する

次に、デプロイパイプラインを作成します。

[ ソース LHs と変数 ] ワークスペースで、[ デプロイパイプラインの作成] を選択します。
パイプライン にDeployment_Pipeline_Var名前を付け、[ 次へ] を選択します。
デプロイパイプラインで、[ 作成して続行] を選択します。
開発ステージの場合:
1. ドロップダウンリストで、ワークスペースの ソース LHs と変数 を選択します。次に、[ 割り当て] チェックマークを選択します。
2. [続行] を選択します。これで、ワークスペースの項目がステージに設定されます。
テスト ステージの場合:
1. 上部にあるチェックボックスをオンにして、すべての項目を選択します。次に、 SourceLH_Dev lakehouse のチェックボックスをオフにします。
2. [ デプロイ ] ボタンを選択します。 [ デプロイ ] をもう一度選択します。 テスト ステージが設定されます。
運用ステージの場合:
1. 上部にあるチェックボックスをオンにして、すべての項目を選択します。次に、 SourceLH_Test lakehouse のチェックボックスをオフにします。
2. [ デプロイ ] ボタンを選択します。 [ デプロイ ] をもう一度選択します。 これで、運用ステージが設定されます。

ステージごとに変数ライブラリのアクティブセットを設定する

これらの手順では、デプロイパイプラインの各ステージのアクティブセットを構成します。

テスト ステージのアクティブセットを構成します。
1. サイドバーで、 Deployment_Pipeline_Var パイプラインを選択します。
2. テスト ステージを選択します。
3. WS 変数を選択します。
4. 省略記号 (...) を選択し、[ アクティブに設定] を選択します。 [ アクティブに設定 ] ボタンを選択します。
  
  これで、アクティブなセットが構成されました。
5. >] を選択します。
Prod ステージのアクティブセットを構成します。
1. サイドバーで、 Deployment_Pipeline_Var パイプラインを選択します。
2. Prod ステージを選択します。
3. WS 変数を選択します。
4. 省略記号 (...) を選択し、[ アクティブに設定] を選択します。 [ アクティブに設定 ] ボタンを選択します。
5. >] を選択します。

変数ライブラリを確認してテストする

変数ライブラリを設定し、デプロイパイプラインの各ステージのすべてのアクティブセットを構成したら、それらを確認できます。

SourceLHs_Devレイクハウスを確認します。
1. [ ソース LHs と変数 ] ワークスペースで、 SourceLHs_Dev lakehouse を選択します。
2. 接続を Lakehouse から SQL 分析エンドポイントに変更します。
3. エクスプローラーで[スキーマ]>dbo>Tables の順に展開します。
4. DevCopiedData テーブルが表示されることを確認します。
SourceLHs_Test lakehouse に切り替えて、前の手順を繰り返します。

テスト VS アクティブセットでパイプラインをまだ実行していないため、TestCopiedData テーブルは表示されません。
SourceLHs_Prod lakehouse に切り替えて、前の手順を繰り返します。

ProdCopiedData テーブルは、Prod VS アクティブセットを使用してパイプラインをまだ実行していないため、表示されません。
Deployment_Pipeline_Var パイプラインのテスト ステージを確認します。
1. Deployment_Pipeline_Var パイプラインに切り替えて、テスト ステージを選択します。
2. Pipeline_Deploy パイプラインを選択します。
3. [実行] を選択します。このプロセスは正常に完了します。
SourceLHs_Testレイクハウスをもう一度確認します。
1. SourceLHs_Testレイクハウスに切り替えます。
2. 接続を Lakehouse から SQL 分析エンドポイントに変更します。
3. エクスプローラーで[スキーマ]>dbo>Tables の順に展開します。
4. TestCopiedData テーブルが表示されることを確認します。
Deployment_Pipeline_Var パイプラインの運用ステージを確認します。
1. Deployment_Pipeline_Var パイプラインに切り替えて、運用ステージを選択します。
2. Pipeline_Deploy パイプラインを選択します。
3. [実行] を選択します。このプロセスは正常に完了します。
SourceLHs_Prodレイクハウスをもう一度確認します。
1. SourceLHs_Prodレイクハウスに切り替えます。
2. 接続を Lakehouse から SQL 分析エンドポイントに変更します。
3. エクスプローラーで[スキーマ]>dbo>Tables の順に展開します。
4. ProdCopiedData テーブルが表示されることを確認します。

Git で変数の値をカスタマイズする (省略可能)

変数ライブラリが Git でどのように表されているかを確認するには、または Git リポジトリから変数を編集します。

ワークスペースで[ ソース管理 ]を選択し、ワークスペースを Git リポジトリに接続します。
[ ソース管理 ] ウィンドウで、[ コミット ] を選択して、ワークスペースの内容を Git リポジトリにプッシュします。

Git リポジトリには、ワークスペース内の各項目のフォルダーがあります。 WS 変数と呼ばれるフォルダー 。VariableLibrary は、変数ライブラリ項目を表します。このフォルダーの内容の詳細については、変数ライブラリ CI/CD を参照してください。

valueSets フォルダー内の ProdVS.json ファイルと TestVS.json ファイルを比較します。 overrides変数が異なる値に設定されていることを確認します。これらの値は、UI で直接編集するか、Git でこのファイルを編集してワークスペースに更新することで編集できます。

{
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

{
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-08-25

次の方法で共有

チュートリアル: 変数ライブラリを使用して項目の構成をカスタマイズおよび共有する

前提条件

Stage LHs ワークスペース、サンプル データを含む lakehouse SourceLH_Stage、パイプラインPipeline_Stage作成する

[変数] ワークスペースを使用してソース LHs を作成する

SourceLH_Dev、SourceLH_Test、SourceLH_Prodのレイクハウスを作成する

lakehouses のワークスペース ID とオブジェクト ID を取得する

変数を含む変数ライブラリを作成する

代替値セットを作成する

Pipeline_Deploy パイプラインを作成し、変数を宣言する

Pipeline_Deploy パイプラインのソース接続を構成する

Pipeline_Deploy パイプラインの宛先接続を構成する

デプロイ パイプラインを作成する

ステージごとに変数ライブラリのアクティブ セットを設定する

変数ライブラリを確認してテストする

Git で変数の値をカスタマイズする (省略可能)

関連コンテンツ

フィードバック

その他のリソース

Stage LHs ワークスペース、サンプルデータを含む lakehouse SourceLH_Stage、パイプラインPipeline_Stage作成する

デプロイパイプラインを作成する

ステージごとに変数ライブラリのアクティブセットを設定する