Microsoft Fabric の変数ライブラリ 項目には、変数とその既定値の一覧が含まれています。 また、代替値を保持する他の値セットを含めることもできます。
変数ライブラリ内の各変数には、次のプロパティがあります。
- 名前
- 注 (省略可能)、最大 2,048 文字
- タイプ
- 既定値セット
- 代替値セット (オプション)
名前付け規則
変数ライブラリ名
変数ライブラリ項目自体の名前は、次の規則に従う必要があります。
- 空ではない
- 先頭または末尾にスペースがありません
- 文字で始まる
- 文字、数字、アンダースコア、ハイフン、スペースを含めることができます
- 長さが 256 文字を超えない
変数名では大文字と小文字は区別 されません 。
変数名
変数ライブラリ内の変数の名前は、次の規則に従う必要があります。
- 空ではない
- 先頭または末尾にスペースがありません
- 文字またはアンダースコアで始まる
- 文字、数字、アンダースコア、ハイフンを含めることができます
- 長さが 256 文字を超えない
変数名では大文字と小文字は区別 "されません"。
値セット名
値セット名には変数名と同じ制限があります。
変数の型
変数に値を追加するには、まず変数の型を定義する必要があります。 変数ライブラリ内の変数には、次のいずれかの型を指定できます。
文字列: 任意の文字。
nullまたは空にすることができます。ブール値:
TrueまたはFalse。DateTime: ISO 8601 標準 yyyy-MM-ddTHH:mm:ss.xxxZ として表される日付と時刻。ここで、
- yyyy-MM-dd は 4 桁の年で、その後に 2 桁の月と 2 桁の日が続きます。
- T は日付と時刻を区切ります。
- HH:mm:ss.xxx は 24 時間形式の 2 桁の時間で、その後に 2 桁の分、2 桁の秒、3 桁のミリ秒が続きます。
- Z は、時刻が協定世界時 (UTC) であることを示します。
たとえば
2025-01-14T16:15:20.123Zです。数値: 任意の数値。
GUID: グローバル一意識別子。
整数: 正、負、またはゼロの整数。
変数の値が定義された後、変数の型を変更しようとすると、同意ダイアログが表示されます。 ダイアログでは、すべての変数値がリセットされ、この変更がコンシューマー項目側で重大な変更になる可能性があることを通知します。
代替値セット
変数ライブラリに新しい値セットを作成すると、新しい値が既定値へのポインターとして設定されます。 これらは固定値に変更できます。
代替値セット内の変数の値を変更すると、値セットの代替値が JSON ファイルに保存されます。 Git のこの JSON ファイルでは、値セットの表示順序を変更したり、代替値セット内の変数の値を変更することができます。
考慮事項と制限事項
サイズ制限
次の両方の要件を満たしている限り、 最大 1,000 個の変数と 最大 1,000 個の値セットを使用できます。
- 代替値セット内のセルの合計数が 10,000 未満です。
- 項目のサイズが 1 MB を超えていない。
これらの要件は、変更を保存するときに検証されます。
メモ フィールドの文字数は最大 2,048 文字です。
値セットの説明フィールドには、最大 2,048 文字を指定できます。
代替値セットの制限事項
- 変数ライブラリの代替値セットは、追加した順序で表示されます。 現時点では、UI で並べ替えることはできません。 順序を変更するには、JSON ファイルを直接編集します。
- 各値セットの名前は、変数ライブラリ内で一意である必要があります。
- 変数名は、変数ライブラリ内で一意である必要があります。 異なるアイテム内にある場合は、ワークスペース内に同じ名前の 2 つの変数を含めることができます。
- 変数ライブラリには、常に 1 つのアクティブな値が一度に 1 つしか設定されていません。 アクティブな間は、値セットを削除できません。 削除するには、まず別の値セットをアクティブに構成します。 デプロイ パイプラインのステージごとに異なるアクティブな値を設定できます。