変数ライブラリとは (プレビュー)

Microsoft Fabric 変数ライブラリは、ワークスペース内の他の項目で使用できる変数のバケットと考えることができます。 これは、リリース パイプラインの各ステージのそれぞれの値と共に変数の一覧を含むワークスペース内の項目として機能します。 これは、ワークスペース内の項目構成を効率的に管理し、さまざまなライフサイクル ステージにわたってスケーラビリティと一貫性を確保するための統合されたアプローチを提供します。

たとえば、変数ライブラリには、次のさまざまな値を保持する変数を含めることができます。

• パイプラインの待機アクティビティで使用される整数。
• "コピー データ" アクティビティのソースとなるレイクハウス参照。 各値は、パイプラインのリリース ステージに基づいて異なるパイプラインで使用されます。
• ノートブックの既定のレイクハウスとして構成されるレイクハウス参照。 各値は、ノートブックのリリース ステージに基づいて異なるパイプラインで使用されます。

コンシューマー項目の値の解決は、必ずしもそのデプロイに関連付けられているわけではありません。 代わりに、各コンシューマー項目は、独自のコンテキストに基づいて値を解決します。

変数ライブラリのエクスペリエンスは変数の種類によって異なりますが、中核的な概念は変わりません。これにより、他の項目で使用できる変数を定義および管理できます。

Fabric 変数ライブラリ:

• CI/CD プロセスと互換性があり、Git との統合と展開パイプラインを介したデプロイが可能。
• Microsoft Fabric パブリック API を使用した自動化をサポート。

変数ライブラリを使用すると、お客様は次のことが可能になります。

• 構成をカスタマイズする。

  変数値は、リリース パイプライン ステージに基づいて構成できます。 ユーザーは、リリース パイプラインのステージごとに 1 つずつ、異なる値のセットを使用して変数ライブラリを構成できます。 次に、各ステージのアクティブな値のセットの 1 回限りの設定の後、パイプライン ステージで正しい値が自動的に使用されます。 いくつかの例を次に示します。

  • ステージに基づいて項目の接続を変更する
  • ステージに基づいて別のクラウド データ ソースに切り替える
  • ステージに基づいてクエリ内のデータ量を調整する

• 構成を共有する

  変数ライブラリは、ワークスペース項目全体の構成を一元的に管理する方法を提供します。 たとえば、ワークスペースに複数の Lakehouse があり、それぞれに同じデータソースを使用するショートカットがある場合は、そのデータソースを変数の 1 つとして変数ライブラリを作成できます。 そうすれば、データ ソースを変更する場合は、各 Lakehouse で個別に変更せずに、変数ライブラリで変更するだけで済みます。

変数ライブラリ構造

コア コンポーネント

変数ライブラリには、1 つ以上の変数が含まれています。 各変数には、名前、型、既定の値があります。 また、各変数に、その目的や使用方法を説明するメモを追加することもできます。

既定値

既定値は、使用する別の値が明示的に定義されていない場合に、使用される値です。
すべての変数には既定値が必要です。 変数の型が String の場合、既定値は null になります。

代替値セット

値セットは、変数ライブラリ内の各変数の値を定義します。 変数ライブラリには通常、複数の値セットが含まれます。 アクティブ (または有効) な値セットには、コンシューマー項目がそのワークスペースに対して受け取る値が含まれます。 各ワークスペースで、アクティブにする値セットを選択します。 ワークスペースのアクティブな値セットは、Git からのデプロイまたは更新中に変更されません。

代替値セットを作成すると、各変数の既定値へのポインターを含む新しい値セットが作成されます。 その後、新しい値セット内の各変数の値を変更できます。

サポートされているアイテム

変数ライブラリをサポートする項目を次に示します。

• データ パイプライン (プレビュー)

• ショートカットに変数を割り当てる (プレビュー)

考慮事項と制限事項

サイズ制限

• 代替値セットのセルの合計数が 10,000 セル未満で、項目のサイズが 1 MB を超えない限り、"最大 1,000 個の変数" および "最大 1,000 個の値セット" を使用できます。 これは、ユーザーが変更を保存するときに検証されます。
• メモ フィールドの文字数は最大 2,048 文字です。
• 値セットの説明フィールドには、最大 2,048 文字を指定できます。

代替値セットの制限事項

• 変数ライブラリの代替値セットは、追加された順序で表示されます。 現時点では、UI で並べ替えることはできません。 順序を変更するには、JSON ファイルを直接編集します。
• 各値セットの名前は、変数ライブラリ内で一意である必要があります。
• 変数名は、変数ライブラリ内で一意である必要があります。 異なる項目にある場合は、ワークスペース内に同じ名前の 2 つの変数を含めることができます。
• 変数ライブラリには、いつの時点においても、アクティブな値セットが常に 1 つ、かつ 1 つのみ設定されます。 アクティブな値セットを削除することはできません。 削除するには、まず別の値をアクティブに設定します。 展開パイプラインのステージごとに異なるアクティブな値セットを設定できます。

関連コンテンツ

• 変数ライブラリのアクセス許可
• 変数ライブラリの使用を開始する