連線參考變數是一種工作空間變數，儲存 外部資料連線的 ID（例如 Snowflake、Azure SQL），讓項目能夠在不嵌入憑證或連線字串的情況下參考外部資源。
使用方式
連線參考變數可以像變數函式庫中的其他變數一樣使用。
- 登入 Microsoft Fabric
- 進入你的工作區和變數庫
- 在頂端選擇 + 新變數
- 提供變數名稱，選擇類型 中的連線參考 ，然後點擊 ...... 以選擇一個值
5. 一旦選定，連線參考應該即可使用。
如果你需要編輯連線參考或需要再次確認該值，你可以右鍵點擊該值，彈出一個包含連結參考資訊的彈出視窗。
運作方式
連線參考變數的值是指向由連接 ID 識別的連接物件的靜態指標。 該值以對應目標連線 ID 的字串形式儲存。 例如：
ConnectionID = aaaa-0000-1111-2222-bbbbbbbbbbbb
此 ID 唯一識別所參考的連線。 靜態參考不會自動調整以適應不同的部署環境。 它要求目標連線在選擇時必須存在，且除非手動更改，否則會一直指向該特定連線。
在使用連線參考時，請注意以下事項：
- 在租戶層級儲存預先定義的連線識別碼。
- 連線參考在部署時不會自動綁定。 它們的數值在不同環境中保持固定。
- 支援 CI/CD 與自動化，透過參數化不同環境（開發、測試、生產）的外部連線。
- 允許外部關係的動態配置（例如，切換不同環境的資料來源或憑證）。
- 數值透過 UI 對話框選擇，而非自由文字，確保只選擇授權連線。
- 只有至少具備讀取權限的連線才可選擇。
Git 與 API 中的表示
Connection reference 是一種進階變數類型，其值結構儲存 connectionId（平台則解析/顯示元資料）。 編輯內容包包括：
- 名稱：連線參考變數的顯示名稱
- 備註：可選，可用於描述或其他備註。
- 類型：「connectionReference」（進階類型）
- value：每個值集合中，每個值會儲存「connectionId: <GUID/ID string>」
範例：
{
"name": "PrimaryDb",
"note": "",
"type": "connectionReference",
"value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
}
建立/使用連線參考所需的權限
使用連線參考變數涉及兩層權限：
- 建立並編輯連線參考變數：工作區中具有貢獻者或以上角色的使用者可以在函式庫中建立和編輯變數，而檢視器則是唯讀。
- 存取連線參考變數：除了變數函式庫的權限外， 你還必須至少對你打算參考的連接參考變數擁有讀取權限 。
欲了解更多關於權限與權限驗證的資訊，請參閱 變數函式庫權限
支援的項目
以下是支援連線參考變數的項目清單：
- Notebook，透過 NotebookUtils
- 使用者資料功能
Python 程式碼範例
以下程式碼範例展示了如何在 Python 腳本中使用連線參考。
var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)
此程式代碼會執行下列動作：
- 從 Fabric 變數函式庫解析連線參考變數
- 擷取連線元資料物件
- 擷取連接ID。
- 列印 ID 以便用於程式碼或 API 呼叫。
局限性
連線參考變數適用以下限制：
- 筆記型電腦內建連接不被支援，因為筆記本連線的connection_id不是同一個。