Microsoft Fabric 变量库是工作区中的其他项可以用作应用程序生命周期管理（ALM）的一部分的变量桶。 它充当工作区中的一个项，该工作区包含变量列表，以及发布管道每个阶段的相应值。 它提供了一种统一的方法，用于在工作区中高效管理项配置，以帮助确保跨生命周期阶段的可伸缩性和一致性。
例如，变量库可以包含保存以下值的变量：
- 要在管道中的等待活动中使用的整数。
- 要作为 复制数据 活动中的源的 Lakehouse 引用。 每个值都基于管道的发布阶段在不同的管道中使用。
- 要配置为笔记本默认 Lakehouse 的 Lakehouse 引用。 每个值都基于笔记本的发布阶段在不同的管道中使用。
使用者项中的值解析不一定绑定到其部署。 相反，每个使用者项都根据自己的上下文解析值。
变量库的体验因变量类型而异，但所有变量库都允许定义和管理其他项可以使用的变量。
Fabric 变量库：
优点
变量库使客户能够自定义和共享配置。
自定义配置
可以根据发布管道阶段配置变量值。 可以使用值集配置变量库：发布管道的每个阶段的一个值。 然后，在每个阶段设置的活动值一次性设置后，管道阶段中会自动使用正确的值。 示例包括：
- 根据阶段更改项的连接。
- 根据阶段切换到其他云数据源。
- 根据阶段调整查询中的数据数量。
共享配置
变量库提供了一种集中的方式来管理工作区项中的配置。 例如，如果工作区中有多个 lakehouse，并且每个湖屋都有使用相同数据源的快捷方式，则可以创建一个变量库，该数据源作为变量之一。 这样，如果要更改数据源，则必须仅在变量库中更改一次。 无需单独在每个湖屋中更改它。
变量库结构
变量库包含一个或多个变量。 每个变量都有一个名称、类型和默认值。 还可以向每个变量添加注释来描述其用途或使用方法。
默认值
默认值是使用的值，除非你专门定义其他值。
所有变量都必须具有默认值。 如果变量类型为 字符串，则默认值可以为 null。
备用值集
值集定义变量库中每个变量的值。 变量库通常包含多个值集。 活动（或有效）值集包含使用者项为该工作区接收的值。
在每个工作区中，选择一个设置为“活动”的值。 工作区的活动值集在部署或从 Git 更新期间不会更改。
创建备用值集时，会使用指向每个变量的默认值的指针创建新值集。 然后，可以更改新值集中每个变量的值。
支持的项目
以下项支持变量库：
- 管道
- Lakehouse 的快捷方式
- 笔记本，通过 NotebookUtils 和
%%configure - 数据流第 2 代
- 复制作业
注意事项和限制
大小限制
只要满足这两项要求，最多可以有 1,000 个变量 和 最多 1,000 个值集：
- 备用值集中的单元格总数小于 10,000。
- 项的大小不超过 1 MB。
保存更改时会验证这些要求。
备注字段最多可包含 2,048 个字符。
值集描述字段最多可包含 2,048 个字符。
替代值集的限制
- 变量库中的替代值集以添加变量库的顺序显示。 目前，无法在 UI 中对它们重新排序。 若要更改顺序，请直接编辑 JSON 文件。
- 每个值集的名称在变量库中必须是唯一的。
- 变量名称在变量库中必须唯一。 如果变量位于不同的项中，则可以在工作区中具有同名的两个变量。
- 一次变量库中始终设置一个（且只有一个）活动值。 在活动时，无法删除设置的值。 若要删除它，请先配置设置为活动的另一个值。 可以为部署管道的每个阶段设置不同的活动值。