变量库与管道的集成

变量库是 Microsoft Fabric 中的新项类型。 通过使用变量库,可以在工作区级别定义和管理变量。 可以在各种工作区项(例如管道、笔记本、Lakehouse 快捷方式等)中使用这些变量。 它提供了一种统一和集中的方式来管理配置,减少对硬编码值的需求并简化 CI/CD 过程。 可以更轻松地跨不同环境管理配置。

如何将变量库与管道配合使用

  1. 转到工作区并创建新项。

    显示在 Fabric 工作区中添加新项的位置的屏幕截图。

  2. 使用筛选器查找变量库或向下滚动到“开发数据”部分。

    显示新变量库项筛选器的屏幕截图。

  3. 选择变量库以创建新的变量库。 输入名称并选择“ 创建”。

    显示一个新的变量库项的屏幕截图,该项已设置名称,并突出显示“创建”按钮。

  4. 创建变量库后,会进入主页。 选择 “+ 新建 ”以添加新变量。

    显示新变量库项的起始页的屏幕截图。

  5. 添加新变量时,可以配置变量并设置名称、类型和默认值。 还可以添加备注。

    显示要为新变量设置的配置的屏幕截图。

  6. 根据需要添加备用值集(例如,为不同部署管道环境分别设置不同的值)。 设置名称并选择“ 创建”后,可以编辑变量值,然后选择要激活的值。

    屏幕截图,其中突出显示了为变量添加新值集的位置。

    显示如何为新值集添加名称的屏幕截图。

  7. 完成后保存更改。

    显示左上角突出显示的“保存”按钮的屏幕截图。

在管道中使用变量库变量

  1. 若要在管道中使用变量库变量,请创建新管道或转到现有管道。

    突出显示左上角的“创建新项”按钮和突出显示的管道项的屏幕截图。

  2. 在您的管道中,在底部面板中创建对变量库中的变量的引用。

    突出显示管道画布底部面板中的“库变量”选项卡和“+新建”按钮的屏幕截图。

  3. 选择“+ 新建”。 此时会打开一个弹出窗口,显示所有变量库。 使用此选取器选择变量库变量,然后选择“ 确定”。

    屏幕截图,其中突出显示了“库变量”选项卡中的“+新建”按钮。

    显示变量选取器中选择的库变量的屏幕截图。

    显示新库变量引用的配置集的屏幕截图。

  4. 在您添加库变量引用后,请添加您的管道活动。 在活动设置中,为您想要参数化的设置选择添加动态内容

    屏幕截图显示了在“查找”活动设置中突出显示的“添加动态内容”。

  5. 表达式生成器随即打开。 如果未看到 库变量,请选择 Functions 旁边的三个点,然后选择 库变量

    显示表达式生成器中的 Functions 旁边的 3 点的屏幕截图,其中突出显示了“库变量”选项卡。

  6. 选择库变量引用以向表达式生成器添加新表达式。 然后选择“ 确定” 以添加表达式。

    屏幕截图显示库变量引用被突出显示以添加到表达式生成器中。

    显示表达式生成器中的表达式集的屏幕截图。

  7. 你会看到动态内容已添加到活动设置。

    显示查找活动设置中表达式设置为动态内容的屏幕截图。

  8. 可以通过选择 预览数据来预览数据。 此操作将打开一个新窗格,新窗格中将会显示库变量的值。 选择 “确定” 获取数据预览。

    显示预览数据选项的屏幕截图。

    显示预览数据窗格的屏幕截图。

  9. 像平常一样保存并运行管道。 您会看到,传递的值是您在变量库中设置为“激活”的值。

    管道画布上突出显示“保存并运行”设置的屏幕截图。

已知的限制

以下已知限制适用于 Microsoft Fabric 的数据工厂管道中的变量库的集成:

  • 变量库支持布尔值、日期时间、Guid、整数、数字和字符串作为数据类型。 在管道中,你可以看到布尔值作为布尔类型、Datetime 作为字符串类型、Guid 作为字符串类型、整数作为整型,以及字符串作为字符串类型。 管道不支持数字类型。
  • 使用与管道集成的变量库支持外部连接参数化。 但是,必须从 设置 | 管理连接和网关中查找连接的 GUID。 可以通过选择你连接名称旁边的 “设置” 来找到连接的 GUID。