Microsoft Fabric 中的变量库项包含变量列表及其默认值。 它还可以包含保存可选值的其他值集。
变量库中的每个变量具有以下属性：
- Name
- 注意（可选），最多 2,048 个字符
- 类型
- 默认值集
- 备用值集 (可选)
命名约定
变量库名称
变量库项本身的名称必须遵循以下约定：
- 不为空
- 没有前导空格或尾随空格
- 以字母开头
- 可以包括字母、数字、下划线、连字符和空格
- 长度不超过 256 个字符
变量库名称 不 区分大小写。
变量名称
变量库内变量的名称必须遵循以下约定：
- 不为空
- 没有前导空格或尾随空格
- 以字母或下划线开头
- 可以包括字母、数字、下划线和连字符
- 长度不超过 256 个字符
变量名称不区分大小写。
值集名称
值集名称与 变量名称具有相同的限制。
变量类型
你必须先定义变量类型，然后才能向变量添加值。 变量库中的变量可以是以下任一类型：
字符串：任何字符。 可以是
null或为空。布尔值：
True或False。DateTime：表示为 ISO 8601 标准 yyyy-MM-ddTHH：mm：ss.xxxZ 的日期和时间，其中：
- yyyy-MM-dd 是四位数年份，后跟两位数月份和两位数的日期。
- T 分隔日期和时间。
- HH：mm：ss.xxx 是 24 小时格式的两位数小时，后跟两位数分钟、两位数秒和三位数毫秒。
- Z 表示时间采用协调世界时（UTC）。
示例为
2025-01-14T16:15:20.123Z。数字：任意数字。
GUID：全局唯一标识符。
整数：可以是正数、负数或零。
变量具有定义的值后，如果尝试更改其类型，将显示同意对话框。 对话框会提醒你将重置所有变量值，并且此更改可能是使用者项端的重大更改。
备用值集
在变量库中创建新值集时，新值将设置为指向默认值的指针。 你可以将它们更改为固定值。
如果更改替代值集中变量的值，则替代值将保存在 JSON 文件中的值集。 可以在 Git 的此 JSON 文件中更改值集的显示顺序，或更改替代值集中变量的值。
注意事项和限制
大小限制
只要满足这两项要求，最多可以有 1,000 个变量 和 最多 1,000 个值集：
- 备用值集中的单元格总数小于 10,000。
- 项的大小不超过 1 MB。
保存更改时会验证这些要求。
备注字段最多可包含 2,048 个字符。
值集描述字段最多可包含 2,048 个字符。
替代值集的限制
- 变量库中的替代值集以添加变量库的顺序显示。 目前，无法在 UI 中对它们重新排序。 若要更改顺序，请直接编辑 JSON 文件。
- 每个值集的名称在变量库中必须是唯一的。
- 变量名称在变量库中必须唯一。 如果变量位于不同的项中，则可以在工作区中具有同名的两个变量。
- 一次变量库中始终设置一个（且只有一个）活动值。 在活动时，无法删除设置的值。 若要删除它，请先配置设置为活动的另一个值。 可以为部署管道的每个阶段设置不同的活动值。