连接引用变量是一个工作区变量，用于存储 外部数据连接的 ID（例如 Snowflake、Azure SQL），允许项在不嵌入凭据或连接字符串的情况下引用外部资源。
如何使用
连接引用变量可以像变量库中的其他变量一样使用。
- 登录到Microsoft Fabric
- 导航到工作区和变量库
- 在顶部，选择“+ 新建变量”
- 提供变量的名称，为类型选择 连接引用 ，然后单击 ... 以选择值
5.选择后，连接引用应可供使用。
如果需要编辑连接引用或需要仔细检查该值，可以右键单击该值以显示一个弹出窗口，其中包含有关连接引用的信息。
工作原理
连接引用变量的值是指向由连接 ID 标识的连接对象的静态指针。 该值存储为对应于目标连接的 ID 的字符串。 例如：
ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
此 ID 唯一标识引用的连接。 静态引用不会自动调整到不同的部署环境。 它要求目标连接在选择时存在，除非手动更改，否则仍指向该特定连接。
使用连接引用时，请记住以下几点：
- 将预定义的连接标识符存储在租户级别。
- 连接引用在部署期间不会自动绑定。 它们的值在环境中保持不变。
- 通过参数化不同环境（开发、测试、生产）的外部连接，支持 CI/CD 和自动化。
- 启用外部关系的动态配置（例如，针对不同环境切换数据源或凭据）。
- 通过 UI 对话框而不是自由文本来选择值，确保只有经过授权的连接是可选的。
- 只有至少具有读取权限的连接才可用于选择。
Git 和 API 中的表示形式
连接引用是一种高级变量类型，其值模式存储 connectionId，并由平台解析和显示元数据。 创作内容包包括：
- 名称：连接引用变量的“displayName”
- 注意：可选，可用于说明或其他备注。
- 类型：“connectionReference”（高级类型）
- 值：每个值集每个值存储 { “connectionId”： “<GUID/ID 字符串>” }
例：
{
"name": "PrimaryDb",
"note": "",
"type": "connectionReference",
"value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
}
创建/使用连接引用所需的权限
使用连接引用变量涉及两层权限：
- 创建和编辑连接引用变量：工作区中具有参与者或以上角色的用户可以在库中创建和编辑变量，而查看者是只读的。
- 访问连接引用变量：除了变量库的权限外，还必须对要引用 的连接引用变量具有至少读取权限 。
有关权限和权限验证的详细信息，请参阅 变量库权限
支持的项目
下面是支持连接引用变量的项列表：
- 笔记本，通过 NotebookUtils
- 用户数据函数
Python 代码示例
下面的代码示例演示如何在 python 脚本中使用连接引用。
var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)
此代码执行以下操作：
- 从构造变量库解析连接引用变量
- 检索连接元数据对象
- 提取连接ID (connectionId)
- 打印 ID，以便在代码或 API 调用中使用。
局限性
以下限制适用于连接引用变量：
- 笔记本中的内置连接不受支持，因为笔记本连接的connection_id不相同。