创建和管理变量库(预览版)

Microsoft Fabric 变量库使开发人员能够在工作区中自定义和共享项配置,从而简化内容生命周期管理。 本文介绍如何创建、管理和使用变量库。

先决条件

若要在 Fabric 中创建变量库项,需要:

开始之前

在创建变量库之前,请确保了解哪些人有它的访问权限

创建变量库项

可以从 Fabric 主页或工作区内部创建变量库项。

  1. 在侧导航栏中,选择“创建”(如果不存在,请选择三个点的图标 ->“创建”)

  2. “数据工厂”部分中,选择“变量库”

    数据工厂部分中变量库位置的 UI 屏幕截图。

  3. 命名新的变量库,然后选择“创建”。 确保名称符合所需的命名规则

此时会出现一个空的变量库。 现在可以向其中添加变量。

空变量库的屏幕截图。其中将显示没有变量,并有一个“新建”变量的绿色按钮。

管理变量库及其中的变量

可以从顶部菜单栏中管理变量库中的变量

变量库的屏幕截图。顶部有一个“新建”变量按钮。

添加变量

若要向库添加新变量,请执行以下操作:

  1. 选择“+ 新变量”
  2. 输入名称(确保其遵循 命名规则
  3. 从下拉列表中选择一个类型(请参阅支持的变量类型的列表)
  4. 输入一个默认值
  5. 添加说明,以解释变量的定义或如何使用变量(可选)
  6. 选择保存

删除或编辑变量

  • 若要删除变量,请选择一个或多个变量,然后选择“删除变量”,随后选择“保存”
  • 若要编辑变量的名称、类型或值集,请更改值并选择“保存”
  • 若要添加另一个备用值集,请选择“添加值集”

注释

编辑变量库中的任何变量后选择“保存”,会触发错误验证检查,以确保所有变量名称和值都有效。 如有任何错误,需修改后方可保存。

添加值集

若要添加另一个可在其他不同阶段使用的值集:

  1. 选择“添加值集”
  2. 为值集命名(确保名称遵循命名规则),并为其填写说明(可选,最多 2,048 个字符)。
  3. 如果要将此值用作此工作区中当前的活动值集,请选择“设为活动”
  4. 输入变量库中所有变量的值
  5. 选择保存

编辑值集

若要编辑值集,请选择值集名称旁边的三个点。

编辑值集选项的屏幕截图。有三个选项:设为活动、重命名和删除。

你有以下选择:

  • 设为此工作区的活动值集
  • 重命名值集
  • 删除值集

选择“保存”。 所有更改仅在保存后生效。

若要将每个变量的变量值重置为默认值,请选择“重置”按钮。

变量库的屏幕截图。变量值旁边有一个重置按钮。

注意事项和限制

大小限制

  • 最多可以有 1,000 个变量 1,000 个值集,只要备用值集中的单元格总数小于 10,000 个单元格,项的大小不超过 1 MB。 当用户保存更改时,会对此进行验证。
  • 备注字段最多可包含 2,048 个字符。
  • 值集描述字段最多可包含 2,048 个字符。

备用值集限制

  • 变量库中的备用值集按添加的顺序显示。 目前,无法在 UI 中对它们重新排序。 若要更改顺序,请直接编辑 JSON 文件。
  • 每个值集的名称在变量库中必须是唯一的。
  • 变量名称在变量库中必须是唯一的。 如果变量位于不同的项中,则可以在同一工作区中具有两个同名变量。
  • 变量库中始终只有一个值集处于活动状态。 无法删除活动值集。 若要删除它,请先将另一个值集设置为“活动”。 可以为部署管道的每个阶段设置不同的活跃值集合。