Microsoft Fabric の変数ライブラリ項目には、変数とその既定値の一覧が含まれています。 また、代替値を保持する他の値セットが含まれる場合もあります。
変数ライブラリの各変数には、次のプロパティがあります。
名前付け規則
変数ライブラリ項目の名前
変数ライブラリ項目自体の名前は、以下の規則に従っている必要があります。
- 空でないこと。
- 先頭または末尾にスペースがないこと。
- 文字で始まること。
- 使用できるのは、文字、数字、アンダースコア、ハイフン、スペース。
- 長さは 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: GUID を表すには、この型を使用します。
- 整数: 正、負、またはゼロの整数。
いったん変数に値を定義した後に、その型を変更しようとすると、同意ダイアログがポップアップ表示され、すべての変数値がリセットされること、およびこの変更がコンシューマーの項目側で破壊的変更になる可能性があることをユーザーに警告します。
代替値セット
変数ライブラリで新しい値セットを作成すると、新しい値は既定値へのポインターとして設定されます。 これらは固定値に変更できます。 代替値セット内の変数の値を変更すると、代替値は値セットの JSON ファイルに保存されます。 値セットの表示順序の変更や、この JSON ファイル内の代替値セットの変数の値の変更は、Git で行うことができます。
考慮事項と制限事項
サイズ制限
- 代替値セットのセルの合計数が 10,000 セル未満で、項目のサイズが 1 MB を超えない限り、"最大 1,000 個の変数" および "最大 1,000 個の値セット" を使用できます。 これは、ユーザーが変更を保存するときに検証されます。
- メモ フィールドの文字数は最大 2,048 文字です。
- 値セットの説明フィールドには、最大 2,048 文字を指定できます。
代替値セットの制限事項
- 変数ライブラリの代替値セットは、追加された順序で表示されます。 現時点では、UI で並べ替えることはできません。 順序を変更するには、JSON ファイルを直接編集します。
- 各値セットの名前は、変数ライブラリ内で一意である必要があります。
- 変数名は、変数ライブラリ内で一意である必要があります。 異なる項目にある場合は、ワークスペース内に同じ名前の 2 つの変数を含めることができます。
- 変数ライブラリには、いつの時点においても、アクティブな値セットが常に 1 つ、かつ 1 つのみ設定されます。 アクティブな値セットを削除することはできません。 削除するには、まず別の値をアクティブに設定します。 展開パイプラインのステージごとに異なるアクティブな値セットを設定できます。