嵌入 Power BI 分页报表
- 版本 :2023.1(当前版本)
嵌入 Power BI 分页报表
借助 Power BI 嵌入式分析,你可创建在完全集成并交互的应用程序中显示分页报表的 Power BI 内容。 使用最适合自己的解决方案嵌入分页报表,为客户嵌入内容或为组织嵌入内容。
本文介绍如何使用嵌入示例教程嵌入分页报表。
先决条件
若要开始使用,则需要具有:
为客户嵌入内容
为组织嵌入内容
服务主体 自己的 Azure Active Directory 租户设置 容量,已启用分页报表工作负载 备注 只需使用 Power BI Premium Gen1 容量启用此工作负载。 如果没有 Azure 订阅,请在开始之前先创建一个免费帐户。
方法
若要使用示例应用嵌入分页报表,请执行以下步骤:
创建工作区。
创建容量。
将工作区分配到容量。
启用分页报表工作负载。
创建并上传分页报表。
使用示例应用程序嵌入内容。
步骤 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 表。容量节点 vCore RAM (GB) EM1/A1 1 2.5 EM2/A2 2 5 EM3/A3 4 10 P1/A4 8 25 P2/A5 16 50 P3/A6 32 100
步骤 3 - 将工作区分配到容量
为客户嵌入内容
为组织嵌入内容
创建容量后,可将应用工作区分配给该容量。 若要使用服务主体将容量分配给工作区,请使用 Power BI REST API。 使用 Power BI REST API 时,请务必使用服务主体对象 ID。 备注 还可使用 Power BI REST API 将分页报表导入工作区。
步骤 4 - 启用分页报表工作负载
备注
只有“Embedded Gen1”才需要此步骤。 如果容量是 Gen2,请继续步骤 5。
创建容量并将工作区分配给该容量后,需要在容量上启用分页报表工作负载。
登录到“Power BI”>“管理门户”>“容量设置”。
选择要将分页报表添加到其中的工作区的容量。
展开“工作负荷”。
激活分页报表工作负荷。
步骤 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 分页报表支持的数据源。
分页报表不支持客户端事件(如
loaded
或rendered
)