有关 Power BI Embedded 的常见问题

借助 Microsoft Power BI Embedded (PBIE)，应用程序开发人员将令人震撼的完全交互式报表嵌入到其应用程序中，而无需从头生成其自己的数据可视化效果和控件。

编写应用程序代码的开发人员和软件公司也称为独立软件供应商 (ISV)。

Power BI 是“软件即服务”分析解决方案，为组织提供最关键业务数据的单一视图。

Microsoft 为想要将视觉对象嵌入到其应用程序中的 ISV 开发了 Power BI Embedded，以帮助他们的客户做出分析决策。 这让 ISV 不必自行生成其自己的分析解决方案。 嵌入式分析使业务用户能够访问业务数据并对其执行查询，以在应用程序中生成见解。

对于需要完整 BI 解决方案的企业而言，Power BI Premium 可以根据它们的需要调整容量，从而提供组织、合作伙伴、客户和供应商的单一视图。 Power BI Premium 可以帮助组织做出决策。 Power BI Premium 是一款 SaaS 产品，能够让用户通过移动应用、内部开发的应用或 Power BI 门户使用内容。

Power BI Embedded 适用于想要将视觉对象嵌入到其应用程序中的 ISV。 由于 Power BI Embedded 适用于应用程序开发人员，应用程序的客户可以使用存储在 Power BI Embedded 容量上的内容（包括组织内外的任何人），因此 Power BI Embedded 能帮助你的客户做出决策。 无法通过“一键式发布到 Web”或“一键式发布到 SharePoint”来共享 Power BI Embedded 容量内容。

Microsoft 建议企业购买 Power BI Premium，这是一款企业级自助式云 BI 解决方案。 我们建议 ISV 为其云端嵌入式分析组件购买 Power BI Embedded。 但是，客户对要购买的产品没有限制。

在某些情况下，除应用嵌入外，ISV（通常是大型 ISV）可能还希望使用 P SKU 在组织内获得预打包 Power BI 服务的额外好处。

若要详细了解 Premium 和 Embedded 版本之间的区别，请参阅我应使用哪种 SKU。

使用 Pro 或者 Premium Per User (PPU) 许可证的嵌入令牌仅用于开发测试，因此 Power BI 主帐户或服务主体仅可生成有限数量的令牌。 购买容量以便在生产环境中嵌入。 购买容量后，便能生成任意多个嵌入令牌。 在开发测试中，你可将免费的嵌入试用令牌用于 Pro 许可证。 若要嵌入到生产环境，必须购买容量。

Embedded Premium 容量不提供现成的垂直自动缩放功能。 若要了解 Embedded Premium 容量的备用自动缩放选项，请参阅 [Autoscaling in Embedded(./azure-pbie-scale-capacity.md#autoscale-your-capacity)。

Power BI Embedded Premium 通过每 30 秒聚合一次利用率记录来评估利用率级别。 每次评估都包括两种不同的聚合：交互式利用率和后台利用率。

交互式利用率的评估方式是，考虑在当前半分钟评估周期中或附近完成的所有交互式操作。

后台利用率是通过考虑过去 24 小时内完成的所有后台操作来评估的，其中每个后台操作仅占总 CPU 成本的 1/2880（每 24 小时有 2880 个评估周期）。

容量由定义的虚拟核心数组成。 Microsoft Fabric Capacity Metrics 应用跟踪容量 v 核心的利用率。 应用中报告的 CPU 使用率导致需要自动缩放。

如果你有包含一个虚拟核心的 A1 容量，则每个评估周期配额是 30 秒 (1*30) 的 CPU 利用率。 如果 CPU 利用率的总和超过了容量中的虚拟核心总配额，则容量进入临时交互请求延迟模式；在此模式下，每个交互请求（如报表加载、视觉对象交互等）在发送到引擎以供执行之前都会被延迟。 延迟量与检测到的重载量成正比。 100% 重载将导致 20 秒的延迟，而小于 10% 的重载是允许的。

如果上一个评估超过 100% 的资源利用率，则容量仍处于交互式请求延迟模式。

以下事件是交互式操作：

• 数据集 - 报表视图、查询、XMLA 读取
• 数据流
• 分页报表 - 分页报表呈现

以下是后台操作：

• 数据集 - 计划刷新、按需刷新、后台查询（刷新后）
• 数据流 - 计划的数据流刷新
• 分页报表 - 数据驱动订阅呈现
• AI

你的指标报表数据集可保留 30 到 45 天内的数据。 你可以使用报表来指示与容量最大资源的接近程度，并且如果你保存每月快照，就可以将它们进行比较以了解增长趋势，并推断出你将达到 100% 资源利用率的速度。

对于 Embedded Premium，有两种方法：

• Power BI 管理门户中的“容量管理”页上有一个利用率通知复选框。 用户可以选择触发警报的阈值（默认值为 80%），以及应将利用率警报发送到的电子邮件地址。
• 使用 Premium CPU 指标配置 Azure 警报。

Power BI 服务可以存储 90 天以上的利用率数据。 如果用户需要更长的数据保留，则可以使用自带 Log Analytics (BYOLA) 来存储更多利用率数据，Embedded Premium 客户可以在 Embedded Premium 正式发布 (GA) 之日前这样做。

在利用率报表左侧，条形图视觉对象显示了报表时间范围内工作区之间的利用率信息。 条形图视觉对象可用于退款，因为每个工作区表示不同的 ISV 客户、业务单位、成本中心或其他可以应用退款的实体。

请参阅 Power BI 嵌入式分析中的容量和 SKU 一文。

• 登录到组织目录（不支持 Microsoft 帐户）。
• 需要拥有 Power BI 租户，即目录中至少有一个用户注册了 Power BI。
• 需要在组织目录中有 Azure 订阅。

• 使用 Power BI 管理门户。

• 在 Power BI 中下载 Microsoft Fabric Capacity Metrics 应用。

• 使用 Azure 诊断日志记录。

尽管现在没有自动缩放，但所有 API 均可随时缩放。

容量预配（缩放/恢复/创建）可能会失败。 可以使用 Get Details API 检查容量的 ProvisioningState：容量 - 获取详细信息来检查容量的预配状态。

使用多地理位置功能，可在不同于 Power BI 主租户位置的区域中购买 Power BI Embedded 容量

当用户被授予对工作区、应用或项的权限时，可能无法通过 API 调用立即使用这些权限。 这可能导致“GET”API 响应中缺少项，或在尝试使用项时出错。 用户可以通过调用 refreshUserPermissions API 来解决此问题，该 API 会更新用户权限。

可以使用 PBI 门户查找 PBI 租户区域。

https://app.powerbi.com/> ? > 关于 Power BI

• 可以为订阅类型为 CSP 的租户创建 PBIE
• 合作伙伴帐户可以登录到客户租户并为将客户租户用户指定为 Power BI 容量管理员的客户租户购买 PBIE

Power BI 要求使用组织帐户注册。 不支持使用 Microsoft 帐户注册 Power BI。

能，可使用 PowerShell cmdlet 和 Azure 资源管理器 REST API 创建和管理 PBIE 资源。

• Rest API
• PowerShell cmdlets

为了将解决方案提升到生产，你需要将应用程序使用的 Power BI 内容（工作区）分配给 Power BI Embedded (A SKU) 容量。

Power BI Embedded 是非区域性的。 这意味着它不依赖于任何特定的 Azure 区域。

有关所有 Azure 产品的区域信息，请参阅 Azure 产品（按区域）。

Power BI Embedded 继续使用 Microsoft Entra ID 进行主用户（指定的 Power BI Pro 或 Premium Per User (PPU) 许可用户）身份验证，或者使用服务主体对 Power BI 中的应用程序进行身份验证。

ISV 可以为其应用程序实现其自己的身份验证和授权。

如果已经有 Microsoft Entra 租户，可以使用现有目录。 还可以为嵌入式应用程序内容安全性创建新的 Microsoft Entra 租户。

若要获取 Microsoft Entra 令牌，请使用 Microsoft 身份验证库中的一个。 有适用于多个平台的客户端库。

已注册应用主屏幕中的“对象 ID”为应用的对象 ID 。

在“本地目录中的托管应用程序 > 属性”部分中找到的对象 ID 为需要使用的服务主体对象 ID。 此对象 ID 用于引用操作的服务主体或更改服务主体对象 ID。 例如以管理员身份将服务主体应用于工作区。

必须拥有 Power BI 帐户才能在 Azure 中购买 Power BI Embedded。 Power BI Embedded 部署区域决定 Power BI 帐户。 管理你在 Azure 中的 Power BI Embedded 资源，以便：

• 纵向/横向扩展
• 添加容量管理员
• 暂停/恢复服务

使用 PowerBI.com 将工作区分配/取消分配给 Power BI Embedded 容量。

关于何时使用 RLS 和 JavaScript 筛选器，经常会出现混淆。 一种方法是用于控制具体用户可以看到的内容，另一种方法则是用于优化用户视图。

使用 RLS，ISV 开发人员在模型创建和嵌入令牌生成过程中控制数据筛选。 最终用户只能看到 ISV 允许其看到的内容。 在这种情况下，用户可以选择查看少于已筛选的内容，但无法通过规避 RLS 配置查看多于已允许的内容。

使用客户端筛选 (JavaScript)，ISV 可能会决定最终用户在初始视图中看到的内容，但 ISV 无法控制最终用户可能会应用于视图本身的更改。 由于用户 JavaScript 客户端代码可以在后端触发数据筛选，不能将其视为安全。

启用服务主体以将其与 Power BI 配合使用后，应用程序的 AD 权限将不再有效。 然后，将通过 Power BI 管理门户管理应用程序权限。

服务主体继承其安全组中的所有 Power BI 租户设置的权限。 若要限制权限，请为服务主体创建专用的安全组并将其添加到相关已启用 Power BI 设置的“特定安全组除外”列表 。

当你以管理员身份将服务主体添加到新工作区时，这种情况很重要 。 可以通过 API 或使用 Power BI 服务管理此任务。

传递应用程序 ID 进行身份验证时，应用程序 ID（也称为客户端 ID）用于创建访问令牌。

若要引用服务主体用于操作或进行更改，请使用服务主体对象 ID - 例如，以管理员身份将服务主体应用于工作区 。

若要通过“为客户嵌入内容”方法嵌入包含分页报表视觉对象的 Power BI 报表，请使用服务主体，并使用多资源嵌入令牌嵌入报表，其中包含以下内容：

• Power BI 报表 ID
• 分页报表 ID（视觉对象连接到的报表）
• 数据集 ID（Power BI 报表）

服务主体必须有权访问报表（分页和 Power BI）。 生成令牌调用的请求正文示例：

{
  "datasets": [
    {
      "id": "a5d577c7-0568-4180-a6d3-0f6cc0ca3df4"
    }
  ],
  "reports": [
    {
      "allowEdit": false,
      "id": "05024421-b4df-483c-a2ce-61202d0323ce"
    },
    {
      "id": "f8612306-f3a8-40e1-a448-d8e05992a007"
    }
  ]
}

否，无法使用服务主体登录 Power BI。

此外，还无法以用户身份使用外部应用程序（SaaS 嵌入）中的内容，只有在生成嵌入令牌时才可以。

Power BI Embedded 性能

Power BI Embedded 是通过 Azure 提供的。

客户会继续支付任何现有 Power BI Premium 购买的费用，直到他们当前的协议期结束，然后可能会根据当时的需要切换 Power BI Premium 购买。

否，Power BI Embedded 包括将解决方案部署并分发给客户所需的基于 Azure 的容量。

客户可以按小时为单位更改使用情况。 Power BI Embedded 服务没有月承诺使用量或年承诺使用量。

根据部署的节点类型，Power BI Embedded 按可预测的每小时费用收费。 只要资源处于活动状态，那么即使没有使用也需要付费。 需要暂停资源才能停止计费。

需要 Power BI Pro 或 Premium Per User (PPU) 许可证或者服务主体才能使用 REST API。 若要将报表添加到 Power BI 工作区，分析人员需要 Power BI Pro 或 Premium Per User (PPU) 许可证或者服务主体。 若要管理 Power BI 租户和容量，管理员必须拥有 Power BI Pro 或者 Premium Per User (PPU) 许可证。

因为 Power BI Embedded 允许使用 Power BI 门户来管理和验证嵌入式内容，所以需要使用 Power BI Pro 或者 Premium Per User (PPU) 许可证对 PowerBI.com 内部的应用进行身份验证，然后才能访问相应存储库中的报表。

不过，若要在应用程序中创建/编辑已嵌入报表，最终用户无需 Pro 或者 Premium Per User (PPU) 许可证，因为该用户根本就不需要是 Power BI 用户。

可以，你可以对 Power BI Embedded 使用你的 Azure 信用额度

因为 Power BI Embedded 属于 Azure，所以可利用注册 Azure 时获得的 200 美元额度使用此服务。

Power BI Embedded 也适用于国家/地区云。

没有针对非营利和教育实体的特殊 Azure 定价。

Power BI 工作区集合（Power BI Embedded 版本 1）是基于 Power BI 工作区集合 Azure 资源的解决方案。 此解决方案允许使用“Power BI 工作区集合”解决方案下的 Power BI 内容 、专用的 API 和用于向 Power BI 验证应用程序的工作区集合密钥，为客户创建 Power BI Embedded 应用程序。

是的，但已在使用 Power BI 工作区集合解决方案的客户可以继续使用它，直到它被弃用。 客户还可以创建新的工作区集合，以及任何仍使用 Power BI 工作区集合解决方案的 Power BI Embedded 应用程序 。

但是，这也意味着不会向任何 Power BI 工作区集合解决方案添加新功能。 我们鼓励客户计划迁移到新的 Power BI Embedded 解决方案。

已在使用 Power BI 工作区集合解决方案的客户可以继续使用它，直至其支持协议结束。

可用区域有：澳大利亚东南部、巴西南部、加拿大中部、美国东部 2、日本东部、美国中北部、欧洲北部、美国中南部、亚洲东南部、英国南部、欧洲西部、印度西部和美国西部。

Power BI Embedded 解决方案中有一些 Power BI 工作区集合无法实现的特性和功能。

一些功能为：

• 所有 PBI 数据源都受到支持。 仅两个 Power BI 工作区集合数据源受到支持。
• Power BI Embedded 解决方案仅支持诸如常见问题、刷新、书签、嵌入仪表板和磁贴以及自定义菜单等功能。
• 容量计费模型。

通过工具，可快速开始并下载示例应用程序，以便开始使用 Power BI 进行嵌入。

• 通过为客户嵌入内容，可为没有 Power BI 帐户的用户嵌入仪表板和报表。 请在嵌入安装程序工具中，运行“为客户嵌入内容”解决方案。
• 通过为组织嵌入内容，可以扩展 Power BI 服务。 请在嵌入安装程序工具中，运行“为组织嵌入内容”解决方案。

若要采用“为客户嵌入”体验，请保存并解压缩 PowerBI-Developer-Samples.zip 文件。 然后打开 PowerBI-Developer-Samples-master\App Owns Data 文件夹，运行 PowerBIEmbedded_AppOwnsData.sln 文件。

若要采用“为组织嵌入”体验，请保存并解压缩 PowerBI-Developer-Samples.zip 文件。 然后打开 PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app 文件夹，运行 pbi-saas-embed-report.sln 文件。

若要了解如何编辑 Microsoft Entra 注册的应用程序，请参阅快速入门：更新 Microsoft Entra ID 中的应用程序。

可以在这里了解如何编辑 Power BI 数据。

有关详细信息，请参阅嵌入应用程序疑难解答。

更多问题？ 尝试参与 Power BI 社区