Microsoft Fabric 中的變數程式庫專案包含變數及其預設值清單。 它也可以包含其他保存替代值的值集。
變數庫中的每個變數都有下列屬性：
- 名稱
- 附註 （選用），最多 2,048 個字元
- 類型
- 預設值集
- 替代值集 （選擇性）
命名慣例
變數程式庫名稱
變數程式庫項目本身的名稱必須遵循下列慣例：
- 不是空的
- 沒有前導或尾隨空格
- 以一封信開頭
- 可以包含字母、數字、底線、連字號和空格
- 長度不超過 256 個字元
變數程式庫名稱 不 區分大小寫。
變數名稱
變數庫內的變數名稱必須遵循下列慣例：
- 不是空的
- 沒有前導或尾隨空格
- 必須以字母或底線開頭
- 可以包含字母、數字、底線和連字號
- 長度不超過 256 個字元
變數名稱不區分大小寫。
值集名稱
值集名稱與 變數名稱具有相同的限制。
變數類型
您必須先定義變數類型，才能將值新增至變數。 變數程式庫中的變數可以是下列任何類型：
字串：任何字元。 可以是
null或空的。布爾值：
True或False。DateTime：以 ISO 8601 標準 yyyy-MM-ddTHH：mm：ss.xxxZ 表示的日期和時間，其中：
- yyyy-MM-dd 是四位數的年份，後面接著兩位數的月份和兩位數的日。
- T 分隔日期和時間。
- HH：mm：ss.xxx 是 24 小時格式的兩位數小時，後面接著兩位數的分鐘、兩位數的秒鐘和三位數的毫秒。
- 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 檔案。
- 每一個值集的名稱在變數程式庫中必須是唯一的。
- 變數名稱在變數程式庫中必須是唯一的。 如果兩個變數位於不同的項目中，則可以在工作區中具有相同的名稱。
- 在任何時間點，變數庫中總是有且只有一個活動的值集。 您無法刪除值集在作用中狀態時。 若要刪除它，請先將另一個值集設定為作用中。 您可以為部署管線的每個階段設定一組不同的活躍值。