如何将 Power BI 工作区集合内容迁移到 Power BI Embedded

项目
06/02/2023

了解如何从 Power BI 工作区集合迁移到 Power BI Embedded。本文提供有关从 Azure Power BI 工作区集合迁移到 Power BI Embedded 的指导。我们还会了解对应用程序更改的期望。

在 Power BI Premium 版本公开上市之后，Power BI 工作区集合资源可继续使用有限时间。企业协议涵盖的客户可以在其现有协议过期之后访问其现有工作区集合。通过直接或 CSP 渠道获取 Power BI 工作区集合的客户可在 Power BI Premium 公开上市之后享有一年时间的访问权限。

重要

虽然迁移依赖于 Power BI 服务，不过在使用嵌入令牌时，应用程序的用户不依赖于 Power BI。用户不需要注册 Power BI 来查看应用程序中嵌入的内容。可以使用此嵌入方法为客户嵌入 Power BI。

Power BI Embedded flow

准备迁移

对于从 Power BI 工作区集合服务迁移转移到 Power BI Embedded，需要进行一些准备工作。需要有一个租户以及具有 Power BI Pro 许可证的用户可用。

请确保你有权访问 Azure Active Directory (Azure AD) 租户。

要使用哪个租户？
- 使用现有公司 Power BI 租户？
- 为应用程序使用单独的租户？
- 为每个客户使用单独的租户？
  
  如果决定为应用程序或每个客户创建新租户，请参阅以下内容之一：
- 创建 Azure Active Directory 租户
- 如何获取 Azure Active Directory 租户。
在此新租户中创建充当应用程序“主”帐户的用户。该帐户需要注册 Power BI，并获得 Power BI Pro 许可证。

Azure AD 中的帐户

租户中需要存在以下帐户。

注意

这些帐户需要具有 Power BI Pro 许可证才能使用应用工作区。

租户管理员用户。

建议嵌入应用工作区中将租户管理员列为成员。
用于创建内容的分析员的帐户。

这些用户应根据需要分配给应用工作区。
应用程序主用户帐户或服务帐户。

应用程序后端会存储此帐户的凭据。使用主帐户获取与 Power BI REST API 一起使用的 Azure AD 令牌。此帐户用于为应用程序生成嵌入令牌。主帐户需要是为进行嵌入而创建的应用工作区的管理员。

此帐户只是组织中用于嵌入用途的常规用户帐户。

应用注册和权限

若要进行 REST API 调用，请向 Azure AD 注册应用程序。添加配置在 Power BI 应用注册页以及 Azure 门户中应用。有关详细信息，请参阅注册 Azure AD 应用以便嵌入 Power BI 内容。

建议使用应用程序主帐户来注册应用程序。

创建应用工作区（必需）

如果应用程序为多个客户提供服务，则可以利用应用工作区提供更好的隔离。将在客户之间隔离仪表板和报表。随后可以对每个应用工作区使用一个 Power BI 帐户以进一步在客户之间隔离应用程序体验，不过可以仅使用一个帐户以保持简单性。

重要

无法使用个人工作区（“我的工作区”）来利用对客户的嵌入。

需要具有 Pro 许可证的用户才能在 Power BI 中创建应用工作区。创建应用工作区的 Power BI 用户在默认情况下是该工作区的管理员。 应用程序主帐户需要是工作区的管理员。

内容迁移

将内容从工作区集合迁移到 Power BI Embedded 可以与当前解决方案并行进行，无需任何停机时间。

可使用“迁移工具”将内容从 Power BI 工作区集合复制到 Power BI Embedded。尤其是你具有许多报表时。有关详细信息，请参阅 Power BI Embedded 迁移工具。

内容迁移主要依赖两个 API。

下载 PBIX - 此 API 可以下载在 2016 年 10 月之后上传到 Power BI 的 PBIX 文件。
导入 PBIX - 此 API 可用于将任何 PBIX 上传到 Power BI。

有关一些相关代码片段，请参阅用于从 Power BI Embedded 迁移内容的代码片段。

报表类型

有几种类型的报表，每种需要不同的迁移流。

缓存数据集和报表

缓存数据集是指已导入数据的 PBIX 文件，而不是采用实时连接或 DirectQuery 连接。

流

从 Power BI 工作区集合工作区调用下载 PBIX API。
保存 PBIX。
为 Power BI Embedded 工作区调用导入 PBIX。

DirectQuery 数据集和报表

流

调用 GET https://api.powerbi.cn/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources 并保存收到的连接字符串。
从 Power BI 工作区集合工作区调用下载 PBIX API。
保存 PBIX。
为 Power BI Embedded 工作区调用导入 PBIX。
通过调用 POST https://api.powerbi.cn/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections 更新连接字符串
通过调用 GET https://api.powerbi.cn/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources 获取 GW ID 和数据源 ID
通过调用 PATCH 更新用户凭据 https://api.powerbi.cn/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}

旧数据集和报表

2016 年 10 月之前上传的报表不支持下载 PBIX 功能。

流

从开发环境中获取 PBIX（内部源代码管理）。
为 Power BI Embedded 工作区调用导入 PBIX。

推送数据集和报表

下载 PBIX 不支持推送 API 数据集。推送 API 数据集数据无法从 Power BI 工作区集合移植到 Power BI Embedded。

流

使用数据集 Json 调用“创建数据集”API 可为 Power BI Embedded 工作区创建数据集。
为创建的数据集重新生成报表*。

可以通过尝试以下方式，使用一些解决方法将推送 API 报表从 Power BI 工作区集合迁移到 Power BI Embedded：

将某个虚拟 PBIX 上传到 Power BI 工作区集合工作区。
克隆推送 API 报表，并将其绑定到步骤 1 中的虚 PBIX。
使用虚 PBIX 下载推送 API 报表。
将虚拟 PBIX 上传到 Power BI Embedded 工作区。
在 Power BI Embedded 工作区中创建推送数据集。
将报表重新绑定到推送 API 数据集。

创建并上传新报表

除了从 Power BI 工作区集合迁移的内容之外，可以使用 Power BI Desktop 创建报表和数据集，然后将这些报表发布到应用工作区。发布报表的最终用户需要具有 Power BI Pro 许可证才能发布到应用工作区。

重新生成应用程序

修改应用程序以使用 Power BI REST API 和 powerbi.com 中的报表位置。
使用应用程序的主帐户重新生成 AuthN/AuthZ 身份验证。可以使用嵌入令牌来允许此用户代表其他用户执行操作。
将报表从 Power BI Embedded 嵌入到应用程序中。有关详细信息，请参阅如何嵌入 Power BI 仪表板、报表和磁贴。

将用户映射到 Power BI 用户

在应用程序中，将在应用程序中管理的用户映射到主 Power BI 凭据以用于应用程序。此 Power BI 主帐户的凭据存储在应用程序中，用于创建嵌入令牌。

做好生产准备时应执行的操作

准备好移动到生产环境时，需要执行以下操作：

如果使用单独租户进行开发，则需要确保应用工作区以及仪表板和报表在生产环境中可用。确保在 Azure AD 中为生产租户创建了应用程序，并分配了正确的应用权限，如步骤 1 所示。
购买符合需求的容量。可以使用嵌入式分析容量规划白皮书来帮助了解可能需要什么。准备好进行购买时，可以在 Azure 门户中购买 Power BI Embedded 资源。
编辑应用工作区，并在“高级”下将它分配给容量。
将更新的应用程序部署到生产环境，然后开始从 Power BI Embedded 嵌入报表。

迁移后

需要在 Power BI 工作区集合中进行一些清理。

在 Power BI 工作区集合的 Azure 服务中删除部署的解决方案的所有工作区。
删除 Azure 中存在的任何工作区集合。

后续步骤

祝贺。应用程序现在迁移到 Power BI Embedded。有关如何嵌入 Power BI 仪表板、报表和数据集的信息，请参阅如何嵌入 Power BI 仪表板、报表和磁贴。

更多问题？尝试咨询 Power BI 社区

通过