创建部署规则

  • 项目

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

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

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

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

注意

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

创建部署规则

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

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

    A screenshot of the deployment rules button, located in the deployment rules.

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

    A screenshot of the deployment rules pane, showing that you can set rules for dataflows, datasets, datamarts, and paginated reports.

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

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

    A screenshot of the deployment rules pane. It shows a selected dataset and the two rule types, data source and parameter, you can configure for it.

    • 数据源规则

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

      • 从列表中选择。

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

      注意

      • 如果你不是要为其创建规则的项目的所有者，或者如果你的项目不包含任何数据源，则“数据源规则”将灰显。
      • 对于数据流、语义模型和分页报表，数据源列表取自源管道阶段。
      • 不能在多个规则中使用同一数据源。

    • 参数规则 - 从参数列表中选择参数；显示当前值。 将值编辑为你希望在每次部署后生效的值。

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

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

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

  • Azure Analysis Services (AAS)

  • Azure Synapse

  • SQL Server Analysis Services (SSAS)

  • Azure SQL Server

  • SQL Server

  • OData 源

  • Oracle

  • SapHana（仅导入模式；不包括直接查询模式）

  • SharePoint

  • Teradata

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

注意事项和限制

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

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

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

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

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

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

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

  • 如果语义模型使用数据流作为其源，则不支持为此类语义模型设定的数据源规则。

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

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

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

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

注意

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

相关内容