Microsoft Fabric 中的變數函式庫是一種專門的項目，集中管理變數的定義與管理，使得跨工作區與項目的可擴展且自動化配置成為可能。
變數函式庫中的變數可以是基本型或進階型別，每個變數在函式庫項目中以名稱唯一識別。
- 變數函式庫中的基本變數類型包括簡單的資料型態，如布林、DateTime（ISO 8601 UTC 格式）、Guid、Integer、Number和String。 這些都是可以直接分配並在不同階段和環境中使用的簡單數值。
- 進階 變數型別則設計用於更複雜的使用情境，例如參考內部 Fabric 項目或外部連線。 這些包括「項目參考」類型，用來儲存工作區和物品 ID，指向特定的 Fabric 項目。
變數函式庫中支援的型別
變數函式庫中的變數具有以下支援的變數類型
| 類型 | 類別 | Description |
|---|---|---|
| 布林值 | 基本 | 代表真/假值。 |
| 整數 | 基本 | 整數不含小數。 |
| Number | 基本 | 數值，包括小數點。 |
| 繩子 | 基本 | 文字值或字元序列。 |
| DateTime | 基本 | 日期與時間以 ISO 8601 標準 yyyy-MM-ddTHH：mm：ss.xxxZ 表示，其中： yyyy-MM-dd 是四位數年份，後面是兩位數的月份和兩位數的日期。 T 分隔日期和時間。 HH：mm：ss.xxx 是 24 小時制的兩位數小時，接著是兩位數的分鐘、兩位數的秒和三位數毫秒。 Z 表示時間為協調世界時 （UTC）。 |
| Guid | 基本 | 全球唯一識別碼用於不同物件識別。 |
| 項目參考 | 進階 | 在 Fabric 變數函式庫中，透過儲存工作區 ID 與項目 ID 來保存對現有 Fabric 項目的參考，例如湖屋、筆記本或資料管線。 |
變數性質
變數庫中的每個變數都有下列屬性：
| 房產 | Description |
|---|---|
| 名稱 | 變數的唯一識別碼。 用於腳本或工作流程中參考變數。 |
| 備註（可選） | 對變數的描述性註解。 可包含上下文、使用說明或特殊指示。 最大長度：2,048 字元。 |
| 類型 | 定義變數的資料型態（例如，字串、整數、布林值、陣列）。 決定該數值如何被解讀與驗證。 |
| 預設值集 | 當沒有其他值提供時，賦予變數的初始值。 確保工作流程的一致性。 預設值集無法重新命名。 |
| 替代數值集（可選） | 額外預定義的數值集合，可在特定條件或情境下套用。 適合特定環境配置或備用選項。 |
命名慣例
變數名稱
變數庫內的變數名稱必須遵循下列慣例：
- 不是空的
- 沒有前導或尾隨空格
- 必須以字母或底線開頭
- 可以包含字母、數字、底線和連字號
- 長度不超過 256 個字元
變數名稱不區分大小寫。
變數具有定義的值後，如果您嘗試變更其類型，則會出現同意對話方塊。 對話方塊會提醒您所有變數值都將重設，且此變更可能是消費者項目端的重大變更。
考慮事項與限制條件
尺寸限制
最多可以有 1,000 個變數 和最多 1,000 個值集，只要您同時滿足以下兩個需求：
- 替代值集中的儲存格總數小於 10,000。
- 項目大小不超過 1 MB。
當您儲存變更時，會驗證這些需求。
備註欄位最多可包含 2,048 個字元。
值集描述欄位最多可包含 2,048 個字元。