创建部署规则

在部署管道中工作时,不同的阶段可能会有不同的配置。 例如,每个阶段都可以具有不同的数据库或不同的查询参数。 开发阶段可能会查询数据库中的示例数据,而测试阶段和生产阶段则查询整个数据库。

在管道阶段之间部署内容时,可以配置部署规则,以更改内容,同时保持某些设置不变。 例如,你可以为生产阶段中的语义模型定义一条指向生产数据库(而不是测试阶段中的数据库)的规则。 规则是在生产阶段在适当的语义模型下定义的。 定义规则后,从测试部署到生产的内容会继承部署规则中定义的值。 只要此规则不变且有效,此它会始终适用。

可以配置数据源规则、参数规则和默认的湖屋规则。 下表列出了可以为其配置规则的项目的类型,以及可为每个项配置的规则类型。

数据源规则 参数规则 默认湖屋规则 详细信息
数据流 用于确定特定数据流的数据源或参数的值。
语义模型 用于确定特定语义模型的数据源或参数的值。
数据集市 用于确定特定数据市场的数据源或参数的值。
分页报表 已为每个分页报表的数据源定义。 用于确定分页报表的数据源。
笔记本 用于确定特定笔记本的默认湖屋。

注意

只有更改同一类型的数据源时,数据源规则才起作用。

创建部署规则

若要创建部署规则,请按照本节的步骤进行操作。 创建所需的所有部署规则后,使用新创建的规则将语义模型从源阶段部署到创建规则的目标阶段。 在将语义模型从源阶段部署到目标阶段之前,将不会应用规则。

  1. 在要为其创建部署规则的管道阶段中,选择“部署规则”。

    位于部署阶段菜单中的“部署规则”按钮的屏幕截图。

  2. 可以设置规则的项列表,以便在窗口中显示。 未列出管道中的所有项。 仅列出了可为其创建规则的类型项(数据流、语义模型、数据市场、笔记本和分页报表)。 若要查找要为其设置规则的项目,请使用搜索功能或筛选功能。

    新 UI 中“部署规则”窗格的屏幕截图,显示可以为数据流、数据集、数据市场和分页报表设置规则。

  3. 选择要为其创建规则的项目。 可以为其创建的规则类型将显示。 例如,如果要为数据流创建规则,则可以创建数据源规则或参数规则。 如果要为笔记本创建规则,可以创建默认的湖屋规则。

  4. 选择要创建的规则类型,展开列表,然后选择“添加规则”。 有两种可以创建的规则类型:

    新部署规则窗格的屏幕截图。它显示了一个所选数据集和两个规则类型(数据源和参数),你可以为它进行配置。

    • 数据源规则

      从数据源列表中,选择要更新的数据源名称。 使用以下方法之一选择一个值,以便替换源阶段中的值:

      • 从列表中选择。

      • 选择“其他”,并手动添加新数据源。 只能更改为同一类型的数据源。

      注意

      • 如果你不是要为其创建规则的项目的所有者,或者如果你的项目不包含任何数据源,则“数据源规则”将灰显。
      • 对于数据流、语义模型和分页报表,数据源列表取自源管道阶段。
      • 不能在多个规则中使用同一数据源。
    • 参数规则 - 从参数列表中选择参数;显示当前值。 将值编辑为你希望在每次部署后生效的值。

    • 默认湖屋规则 此规则仅应用于笔记本。 选择要连接到目标阶段中的笔记本的湖屋,并将其设置为其默认值。 有关详细信息,请参阅部署管道中的笔记本

数据流和语义模型规则支持的数据源

可以为以下数据源定义数据源规则:

  • Azure Analysis Services (AAS)

  • Azure Synapse

  • SQL Server Analysis Services (SSAS)

  • Azure SQL Server

  • SQL Server

  • OData 源

  • Oracle

  • SapHana(仅导入模式;不包括直接查询模式)

  • SharePoint

  • Teradata

对于其他数据源,我们建议使用参数来配置数据源

注意事项和限制

本节列出了部署规则的限制。

  • 若要创建部署规则,你必须是要为其创建规则的项的所有者。

  • 不能在开发阶段创建部署规则。

  • 移除或删除项时,其规则也会被删除。 这些规则无法还原。

  • 如果取消分配后重新分配工作区以重新建立连接,则会丢失该工作区的规则。 若要使用这些规则,需要重新配置它们。

  • 如果更改在规则中定义的数据源或参数,或将它们从在源阶段指向的项中删除,则该规则将不再有效,且部署将失败。

  • 使用数据源规则部署分页报表后,无法使用 Power BI Report Builder 打开该报表。

  • 部署规则仅在下次部署到该阶段时生效。 但是,如果创建规则并在部署前比较这些阶段,则会根据创建的规则(即使这些规则尚未生效)进行比较。

  • 不支持以下方案:

    • 将其他数据流作为源的数据流的数据流规则。

    • 数据流中常见数据模型 (CDM) 文件夹的数据源规则。

    • 使用数据流作为其源的语义模型的数据源规则。

    • 为将本机查询和 DirectQuery 一起使用的语义模型创建数据源规则。

    • 分页报表不支持参数规则。

    • 在参数化的数据源上为语义模型和数据流添加数据源规则。