Microsoft Fabric 変数ライブラリは、ワークスペース内の他の項目がアプリケーション ライフサイクル管理 (ALM) の一部として使用できる変数のバケットです。 これは、リリース パイプラインの各ステージのそれぞれの値と共に変数の一覧を含むワークスペース内の項目として機能します。 ワークスペース内の項目構成を効率的に管理するための統一されたアプローチを提供し、ライフサイクル ステージ全体のスケーラビリティと一貫性を確保します。
たとえば、変数ライブラリには、次の値を保持する変数を含めることができます。
- パイプラインの待機アクティビティで使用される整数。
- コピー データ アクティビティのソースとなるレイクハウス参照。 各値は、パイプラインのリリース ステージに基づいて、異なるパイプラインで使用されます。
- ノートブックの既定のレイクハウスとして設定するためのレイクハウスの参照。 各値は、ノートブックのリリース ステージに基づいて、異なるパイプラインで使用されます。
コンシューマー項目の値の解決は、必ずしもそのデプロイに関連付けられているわけではありません。 代わりに、各コンシューマー項目は、独自のコンテキストに基づいて値を解決します。
変数ライブラリのエクスペリエンスは変数の型によって異なりますが、すべての変数ライブラリでは、他の項目で使用できる変数を定義および管理できます。
ファブリック変数ライブラリ:
- 継続的インテグレーションおよび継続的デリバリー (CI/CD) プロセスと互換性があります。 この互換性により、デプロイ パイプラインを使用して Git とデプロイを統合できます。
- Fabric パブリック API を使用した自動化をサポートします。
メリット
変数ライブラリを使用すると、お客様は構成をカスタマイズして共有できます。
構成をカスタマイズする
リリース パイプライン ステージに基づいて変数値を構成できます。 変数ライブラリは、リリース パイプラインのステージごとに 1 つの値のセットを使用して構成できます。 次に、ステージごとに設定されたアクティブな値の 1 回限りの設定の後、パイプライン ステージで正しい値が自動的に使用されます。 たとえば、次のようになります。
- ステージに基づいて項目の接続を変更する。
- ステージに基づいて別のクラウド データ ソースに切り替える。
- ステージに基づいてクエリ内のデータ量を調整する。
構成を共有する
変数ライブラリは、ワークスペース項目全体の構成を一元的に管理する方法を提供します。 たとえば、ワークスペースに複数のレイクハウスがあり、それぞれに同じデータ ソースを使用するショートカットがある場合は、そのデータ ソースを変数の 1 つとして変数ライブラリを作成できます。 そうすれば、データ ソースを変更する場合は、変数ライブラリで 1 回だけ変更する必要があります。 各レイクハウスで個別に変更する必要はありません。
変数ライブラリ構造
変数ライブラリには、1 つ以上の変数が含まれています。 各変数には、名前、型、既定値があります。 また、各変数に、その目的や使用方法を説明するメモを追加することもできます。
既定値
既定値は、別の値を明示的に定義しない限り使用される値です。
すべての変数には既定値が必要です。 変数の型が 文字列の場合、既定値は nullできます。
代替値セット
値セットは、変数ライブラリ内の各変数の値を定義します。 変数ライブラリには通常、複数の値セットが含まれています。 アクティブ (または有効) の値セットには、コンシューマーアイテムがそのワークスペースに対して受け取る値が含まれます。
各ワークスペースで、アクティブにする値セットを選択します。 Git からのデプロイまたは更新中に、ワークスペースのアクティブな値セットは変更されません。
代替値セットを作成すると、各変数の既定値へのポインターを含む新しい値セットが作成されます。 その後、新しい値セット内の各変数の値を変更できます。
サポートされているアイテム
変数ライブラリをサポートする項目を次に示します。
考慮事項と制限事項
サイズ制限
次の両方の要件を満たしている限り、 最大 1,000 個の変数と 最大 1,000 個の値セットを使用できます。
- 代替値セット内のセルの合計数が 10,000 未満です。
- 項目のサイズが 1 MB を超えていない。
これらの要件は、変更を保存するときに検証されます。
メモ フィールドの文字数は最大 2,048 文字です。
値セットの説明フィールドには、最大 2,048 文字を指定できます。
代替値セットの制限事項
- 変数ライブラリの代替値セットは、追加した順序で表示されます。 現時点では、UI で並べ替えることはできません。 順序を変更するには、JSON ファイルを直接編集します。
- 各値セットの名前は、変数ライブラリ内で一意である必要があります。
- 変数名は、変数ライブラリ内で一意である必要があります。 異なるアイテム内にある場合は、ワークスペース内に同じ名前の 2 つの変数を含めることができます。
- 変数ライブラリには、常に 1 つのアクティブな値が一度に 1 つしか設定されていません。 アクティブな間は、値セットを削除できません。 削除するには、まず別の値セットをアクティブに構成します。 デプロイ パイプラインのステージごとに異なるアクティブな値を設定できます。