Microsoft Fabric 变量库使开发人员能够在工作区中自定义和共享项配置,从而简化内容生命周期管理。 本文介绍如何创建、管理和使用变量库。
先决条件
若要在 Fabric 中创建变量库项,需要:
具有有效订阅的 Fabric 租户帐户。 免费创建帐户。
从管理员门户启用以下租户开关:
- 用户可以创建 Fabric 项
- 用户可以创建变量库
租户管理员、容量管理员或工作区管理员可以根据组织的设置启用这些开关。
开始之前
在创建变量库之前,请确保了解哪些人有它的访问权限。
创建变量库项
可以从 Fabric 主页或工作区内部创建变量库项。
在侧导航栏中,选择“创建”(如果不存在,请选择三个点的图标 ->“创建”)
在“数据工厂”部分中,选择“变量库”
命名新的变量库,然后选择“创建”。 确保名称符合所需的命名规则。
此时会出现一个空的变量库。 现在可以向其中添加变量。
管理变量库及其中的变量
可以从顶部菜单栏中管理变量库中的变量
添加变量
若要向库添加新变量,请执行以下操作:
删除或编辑变量
- 若要删除变量,请选择一个或多个变量,然后选择“删除变量”,随后选择“保存”。
- 若要编辑变量的名称、类型或值集,请更改值并选择“保存”。
- 若要添加另一个备用值集,请选择“添加值集”。
注释
编辑变量库中的任何变量后选择“保存”,会触发错误验证检查,以确保所有变量名称和值都有效。 如有任何错误,需修改后方可保存。
添加值集
若要添加另一个可在其他不同阶段使用的值集:
- 选择“添加值集”
- 为值集命名(确保名称遵循命名规则),并为其填写说明(可选,最多 2,048 个字符)。
- 如果要将此值用作此工作区中当前的活动值集,请选择“设为活动”
- 输入变量库中所有变量的值
- 选择保存
编辑值集
若要编辑值集,请选择值集名称旁边的三个点。
你有以下选择:
- 设为此工作区的活动值集
- 重命名值集
- 删除值集
选择“保存”。 所有更改仅在保存后生效。
若要将每个变量的变量值重置为默认值,请选择“重置”按钮。
注意事项和限制
大小限制
- 最多可以有 1,000 个变量和 1,000 个值集,只要备用值集中的单元格总数小于 10,000 个单元格,项的大小不超过 1 MB。 当用户保存更改时,会对此进行验证。
- 备注字段最多可包含 2,048 个字符。
- 值集描述字段最多可包含 2,048 个字符。
备用值集限制
- 变量库中的备用值集按添加的顺序显示。 目前,无法在 UI 中对它们重新排序。 若要更改顺序,请直接编辑 JSON 文件。
- 每个值集的名称在变量库中必须是唯一的。
- 变量名称在变量库中必须是唯一的。 如果变量位于不同的项中,则可以在同一工作区中具有两个同名变量。
- 变量库中始终只有一个值集处于活动状态。 无法删除活动值集。 若要删除它,请先将另一个值集设置为“活动”。 可以为部署管道的每个阶段设置不同的活跃值集合。