有关 Power BI Embedded 的常见问题解答

Microsoft Power BI Embedded （PBIE），应用程序开发人员无需从头开始生成自己的数据可视化和控件即可将令人惊叹的完全交互式报表嵌入到应用程序中。

开发人员和软件公司，也称为独立软件供应商（ISV），编码应用程序。

Power BI 是一种软件即服务分析解决方案，可让组织单一查看其最关键的业务数据。

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

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（通常很大），还希望使用 P SKU 来获取其组织中预打包的 Power BI 服务的额外优势。

有关 Premium 与 Embedded 之间的差异的详细信息，请参阅 应使用哪个 SKU。

嵌入具有 Pro 或 Premium Per User （PPU） 许可证的令牌用于开发测试，因此 Power BI 主帐户或 服务主体 只能生成有限数量的令牌。 购买容量，以便在生产环境中嵌入。 购买容量时可以生成的嵌入令牌数没有限制。 在开发测试中，可以使用 Pro 许可证的免费嵌入试用令牌。 若要嵌入生产环境，必须购买容量。

嵌入式高级容量不提供现成的垂直自动缩放功能。 若要了解嵌入式高级容量的替代自动缩放选项，请参阅 Embedded中的 自动缩放。

Power BI Embedded Premium 每隔 30 秒聚合一次利用率记录来评估利用率级别。 每个评估由两个不同的聚合组成：交互式利用率 和 后台利用率。

交互式利用率 通过考虑当前半分钟评估周期或接近当前半分钟评估周期完成的所有交互式操作进行评估。

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

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

如果有一个具有一个 v 核心的 A1 容量，则每个评估周期配额为 CPU 利用率 30 秒（1*30）。 如果 CPU 使用率总和超出容量中的 v 核心配额总量，容量将进入临时 交互式请求延迟 模式，在此期间，每个交互式请求（例如报表加载、视觉交互等）都会延迟，然后再将其发送到引擎执行。 延迟量与检测到的重载量成正比。 重载 100% 会产生 20 秒的延迟，而允许小于 10% 的重载。

如果以前的评估大于 100% 资源使用率，容量将保持在 交互式请求延迟 模式。

以下事件是交互式操作：

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

以下是后台操作：

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

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

嵌入式高级版有两个选项：

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

Power BI 服务存储超过 90 天的利用率数据。 需要较长数据保留期的用户可以使用“自带 Log Analytics”（BYOLA）来存储更多利用率数据，该数据将在 Embedded Premium 正式版（GA）日期前提供给 Embedded Premium 客户。

在利用率报表的左侧，条形图视觉对象显示工作区之间的时间跨度利用率信息。 条形图视觉对象可用于退款，前提是每个工作区代表不同的 ISV 客户、业务部门、成本中心或其他可应用退款的实体。

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

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

• 使用 Power BI 管理门户。

• 在 Power BI 中下载 Microsoft Fabric 容量指标应用。

• 使用 Azure 诊断日志记录。

虽然现在没有自动缩放，但所有 API 随时都可以进行缩放。

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

借助 多地理位置 功能，可以在与 Power BI 主租户位置不同的区域中购买 Power BI Embedded 容量

向用户授予对工作区、应用或项的权限时，可能无法通过 API 调用立即获得该权限。 结果可以是“GET”API 响应中缺少的项，也可以是尝试使用该项时出错。 用户可以通过调用 refreshUserPermissions API来解决此问题，从而更新用户权限。

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

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

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

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

是的，可以使用 PowerShell cmdlet 和 Azure 资源管理器 REST API 来创建和管理 PBIE 资源。

• Rest API
• PowerShell cmdlet

若要 将解决方案提升到生产，需要将应用程序使用的 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。 例如，将服务主体作为管理员应用到工作区。

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

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

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

使用 RLS 与 JavaScript 筛选器时，通常会感到困惑。 一种方法是控制特定用户可以看到的内容，另一种方法是优化用户的视图。

使用 RLS，ISV 开发人员控制数据筛选，作为模型创建和嵌入令牌生成的一部分。 最终用户只看到 ISV 允许用户查看的内容。 在这种情况下，用户可以选择查看小于正在筛选的内容，但无法绕过 RLS 配置并查看更多内容。

使用客户端筛选（JavaScript），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）是基于 Azure 资源 Power BI 工作区集合的解决方案。 通过此解决方案，可以使用 Power BI 工作区集合 解决方案、专用 API 和工作区收集密钥 下的 Power BI 内容为客户创建 Power BI Embedded 应用程序，以向 Power BI 验证应用程序。

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

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

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

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

某些 Power BI Embedded 解决方案特性和功能，你无法 Power BI 工作区集合。

一些功能包括：

• 支持所有 PBI 数据源。 仅支持两 Power BI 工作区集合 数据源。
• Power BI Embedded 解决方案仅支持 Q&A、刷新、书签、嵌入仪表板 & 磁贴和自定义菜单等功能。
• 容量计费模型。

嵌入设置工具 使你能够快速开始和下载示例应用程序，以开始使用 Power BI 进行嵌入。

• 为客户嵌入 提供向没有 Power BI 帐户的用户嵌入仪表板和报表的功能。 在 嵌入设置工具中，为客户 解决方案运行 嵌入。
• 为组织嵌入 允许扩展 Power BI 服务。 在 嵌入设置工具中，为组织 解决方案运行 嵌入。

如果要为客户使用 Embed 体验，请保存并解压缩 PowerBI-Developer-Samples.zip 文件。 然后打开 PowerBI-Developer-Samples-master\App Owns Data 文件夹并运行 PowerBIEmbedded_AppOwnsData.sln 文件。

如果要为组织 体验使用 Embed，请保存并解压缩 文件。 然后打开 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 社区