创建和管理变量库

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

有关该过程的更详细演练，请参阅 有关使用变量库的教程。

Prerequisites

若要在 Fabric 中创建变量库项，需要：

• 具有有效订阅的 Fabric 租户帐户。 免费创建帐户。

• 具有支持 Microsoft Fabric 的容量的工作区。

• 从管理门户启用的以下 租户切换 ：

  • 用户可以创建 Fabric 项

  • 用户可以使用变量库

    

  租户管理员、容量管理员或工作区管理员可以根据 组织的设置启用这些开关。

Fabric 变量库的安全注意事项和权限管理

结构变量库是强大的构造，可跨多个 Fabric 项集中管理变量。 但是，这种灵活性引入了关键的安全注意事项。

由于变量库本身是 Fabric 项，因此它们由自己的 权限 集管理。 这些权限集可能与使用其变量的项不同。 这种差异可能导致用户对变量库具有写入访问权限但缺少对使用项的任何访问权限的情况。

在这种情况下，未经授权的用户可以以有意或无意更改依赖 Fabric 项的行为的方式修改变量值。 此功能可创建潜在的攻击途径，其中共享变量的恶意更新可能会损害这些项的完整性、安全性或功能。

若要缓解这些风险，请遵循以下关键做法：

• 采用严格的权限控制：管理员必须仔细管理对变量库的写入 权限 ，以便只有受信任的用户或服务才能修改它们。 这种做法包括避免过度宽松的访问和定期审核权限分配。
• 使用受信任的库引用：项应仅从显式指定为受信任的库引用变量。 应通过治理策略强制实施此信任模型，这些策略在开发和部署期间验证变量引用的来源。

有关详细信息，请参阅 变量库权限。

创建变量库项

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

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

管理变量库及其变量

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

添加变量

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

1. 选择 “+ 新建变量”。
2. 输入名称。 请确保它遵循 命名约定。
3. 在下拉列表中，选择一个类型。 请参阅支持的变量类型的列表。
4. 输入默认值。
5. 添加说明，说明变量的用途或如何使用变量（可选）。
6. 选择“保存”。

删除或编辑变量

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

添加值集

若要添加可在不同阶段中使用的另一个值集：：

1. 选择 “添加值集”。

2. 命名值集。 请确保它遵循 命名约定。 提供最多 2,048 个字符的说明（可选）。

3. 如果要将此值用作此工作区中当前活动设置的值，请选择“ 设为活动”。

4. 输入变量库中所有变量的值。

5. 选择“保存”。

编辑值集

编辑值集：

1. 选择值集名称旁边的三个点。

2. 选择“ 设置为活动 ”（为此工作区）、 “重命名”或 “删除”。

   

3. 选择“保存”。 更改仅在保存后生效。

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

注意事项和限制

大小限制

• 只要满足这两项要求，最多可以有 1,000 个变量 和 最多 1,000 个值集：

  • 备用值集中的单元格总数小于 10,000。
  • 项的大小不超过 1 MB。

  保存更改时会验证这些要求。

• 备注字段最多可包含 2,048 个字符。

• 值集描述字段最多可包含 2,048 个字符。

替代值集的限制

• 变量库中的替代值集以添加变量库的顺序显示。 目前，无法在 UI 中对它们重新排序。 若要更改顺序，请直接编辑 JSON 文件。
• 每个值集的名称在变量库中必须是唯一的。
• 变量名称在变量库中必须唯一。 如果变量位于不同的项中，则可以在工作区中具有同名的两个变量。
• 一次变量库中始终设置一个（且只有一个）活动值。 在活动时，无法删除设置的值。 若要删除它，请先配置设置为活动的另一个值。 可以为部署管道的每个阶段设置不同的活动值。