変数ライブラリの作成と管理 (プレビュー)

Microsoft Fabric 変数ライブラリを使用すると、開発者はワークスペース内での項目構成をカスタマイズして共有し、コンテンツのライフサイクル管理を合理化できます。 この記事では、変数ライブラリを作成、管理、使用する方法について説明します。

前提条件

Fabric で変数ライブラリ項目を作成するには、次のものが必要です。

• アクティブなサブスクリプションが含まれる Fabric テナント アカウント。 無料でアカウントを作成できます。

• Microsoft Fabric 対応の容量を持つワークスペース

• 管理ポータルから次のテナント スイッチを有効にする必要があります。

  • ユーザーは Fabric 項目を作成できる
  • ユーザーは変数ライブラリを作成できます

  

  これらのスイッチは、 組織の設定に応じて、テナント管理者、容量管理者、またはワークスペース管理者が有効にすることができます。

開始する前に

変数ライブラリを作成する前に、どのユーザーがアクセス許可を持つのかを理解しておく必要があります。

変数ライブラリ項目を作成する

変数ライブラリ項目は、Fabric ホーム ページまたはお使いのワークスペース内から作成できます。

空の変数ライブラリが表示されます。 これで変数を追加できるようになりました。

変数ライブラリとその変数を管理する

上部のメニュー バーから変数ライブラリで変数を管理できます

変数を追加する

ライブラリに新しい変数を追加するには次を行います。

1. [+ 新しい変数] を選択します
2. 名前を入力します (名前付け規則に従っていることを確認してください)
3. ドロップダウン リストから型を選択します (サポートされている変数型の一覧を参照してください)
4. 既定値の入力
5. 変数の目的や使用方法を説明するメモを追加します (省略可能)
6. [保存] を選びます。

変数を削除または編集する

• 変数を削除するには、1 つ以上の変数を選択し、[変数の削除] を選択してから [保存] を選択します。
• 変数の名前、型、または値セットを編集するには、内容を変更して [保存]を選択します。
• さらに代替値セットを追加するには、[値セットの追加] を選択します。

値セットを追加する

別のステージで使用できる値セットをさらに追加するには次の手順に従います。

1. [値セットの追加] を選択します
2. 値セットに名前を付け (名前付け規則に従っていることを確認してください)、最大 2,048 文字の説明 (省略可能) を指定します。
3. この値を、このワークスペースでの現在アクティブな値セットとして使用する場合は、[アクティブとして設定] を選択します
4. 変数ライブラリ内のすべての変数の値を入力します
5. [保存] を選びます。

値セットを編集する

値セットを編集するには、値セットの名前の横にある 3 つのドットを選択します。

次のオプションがあります。

• このワークスペースのアクティブな値セットとして設定する
• 値セットの名前を変更する
• 値セットを削除する

保存 を選択します。 変更は、保存した後にのみ有効になります。

各変数の変数値を既定値にリセットするには、リセット ボタンを選択します。

考慮事項と制限事項

サイズ制限

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

代替値セットの制限事項

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