嵌入 Power BI 分页报表

  • 版本 :2023.1(当前版本)

嵌入 Power BI 分页报表

借助 Power BI 嵌入式分析,你可创建在完全集成并交互的应用程序中显示分页报表的 Power BI 内容。 使用最适合自己的解决方案嵌入分页报表,为客户嵌入内容或为组织嵌入内容。

本文介绍如何使用嵌入示例教程嵌入分页报表。

先决条件

若要开始使用,则需要具有:

  • 为客户嵌入内容

  • 为组织嵌入内容

  • 服务主体

  • 自己的 Azure Active Directory 租户设置

  • 容量,已启用分页报表工作负载

    备注

    只需使用 Power BI Premium Gen1 容量启用此工作负载。

如果没有 Azure 订阅,请在开始之前先创建一个免费帐户。

方法

若要使用示例应用嵌入分页报表,请执行以下步骤:

  1. 创建工作区。

  2. 创建容量。

  3. 将工作区分配到容量。

  4. 启用分页报表工作负载。

  5. 创建并上传分页报表。

  6. 使用示例应用程序嵌入内容。

步骤 1 - 创建工作区

  • 为客户嵌入内容

  • 为组织嵌入内容

由于使用服务主体登录应用程序,需要创建工作区。

服务主体还必须是 Power BI 工作区的管理员或成员。

步骤 2 - 创建容量

  • 为客户嵌入内容

  • 为组织嵌入内容

在将分页报表导入或上传到嵌入之前,必须为包含该报表的工作区分配容量。 有两种类型的容量可供选择:

  • Power BI Premium:为了嵌入分页报表,需要 EM 或 P SKU。 有关此订阅的详细信息,请参阅什么是 Power BI Premium?

  • Azure Power BI Embedded - 可以从 Microsoft Azure 门户购买容量。 此订阅使用 A SKU。 有关如何创建 Power BI Embedded 容量的详细信息,请参阅在 Azure 门户中创建 Power BI Embedded 容量。

下表介绍每个 SKU 的资源和限制。 若要确定最能满足你需求的容量,请参阅应该为我的方案购买哪一个 SKU 表。

容量节点vCoreRAM (GB)
EM1/A112.5
EM2/A225
EM3/A3410
P1/A4825
P2/A51650
P3/A632100

步骤 3 - 将工作区分配到容量

  • 为客户嵌入内容

  • 为组织嵌入内容

创建容量后,可将应用工作区分配给该容量。

若要使用服务主体将容量分配给工作区,请使用 Power BI REST API。 使用 Power BI REST API 时,请务必使用服务主体对象 ID。

备注

还可使用 Power BI REST API 将分页报表导入工作区。

步骤 4 - 启用分页报表工作负载

备注

只有“Embedded Gen1”才需要此步骤。 如果容量是 Gen2,请继续步骤 5。

创建容量并将工作区分配给该容量后,需要在容量上启用分页报表工作负载。

  1. 登录到“Power BI”>“管理门户”>“容量设置”。

  2. 选择要将分页报表添加到其中的工作区的容量。

    选择容量

  3. 展开“工作负荷”。

    展开“工作负荷”

  4. 激活分页报表工作负荷。

    分页报表工作负荷

步骤 5 - 创建并上传分页报表

可使用 Power BI 报表生成器创建分页报表,然后将报表上传到服务。

备注

上传分页报表的用户需要 Power BI Pro 或 Premium Per User (PPU) 许可证才能发布到工作区。

步骤 6 - 使用示例应用程序嵌入内容

  • 为客户嵌入内容

  • 为组织嵌入内容

按照为客户嵌入内容教程中的说明进行操作。 跳过步骤 4 - 创建并发布 Power BI 报表并使用已上传的分页报表,而不是本教程中建议的示例报表。

  • 将 Power BI 数据集用作数据源:

    • 在 Power BI 门户中,将“XMLA 终结点”设置为“只读”或“读写”,如为 Premium 容量启用读写中所述。 针对每个容量只需执行一次。

    • 使用请求中指定的数据集 ID 生成多资源嵌入令牌,并将 XmlaPermissions 设置为“只读”。

  • 使用已启用单一登录 (SSO) 的数据源:

    如果已启用 SSO 的数据源直接连接到分页报表,或连接到作为分页报表数据源的 Power BI 数据集,则支持这些数据源。 如果嵌入包含已启用 SSO 的数据源的分页报表,那么在生成多资源嵌入令牌时,必须在 DatasourceIdentity 中提供该数据源的标识 Blob。

注意事项和限制

  • 为客户嵌入内容的限制

  • 为组织嵌入内容的限制

  • 必须使用“服务主体”。 不支持主用户。

  • 不支持 Premium Per User (PPU)。

  • 以 Power BI 数据集嵌入分页报表时,分页报表和 Power BI 数据集都必须驻留在 Premium Per Capacity 或嵌入式工作区中(它们可以驻留在两个不同的工作区中)。 生成嵌入令牌的用户应该在报表和数据集的工作区中具有“写入”权限。

  • 不支持在启用单一登录 (SSO) 的情况下嵌入连接到 Azure Analysis Services 的分页报表

有关支持的数据集及其身份验证方法的完整列表,请参阅 Power BI 分页报表支持的数据源。

  • 分页报表不支持客户端事件(如 loadedrendered