以增强型报表格式创建 Power BI 报表

适用范围:Power BI Desktop Power BI 服务

Power BI 项目文件 (PBIP) 的 Power BI 增强型报表格式 (PBIR) 是实现 Power BI Desktop 开发人员模式的主要目标中的一个里程碑。 它提供源代码管理友好的文件格式,以消除共同开发障碍并提高开发效率。

采用 TMDL 和 PBIR 的 Power BI 项目的示意图。

Power BI 项目 (PBIP) 支持使用源代码管理友好格式将报表和语义模型保存到文件夹中:

  • 报表的 PBIR。
  • 语义模型的 TMDL。

PBIR 文件格式简化了变更跟踪和合并冲突的解决。 它使用格式正确的 JSON,并将每个视觉对象、页面和书签等组织在文件夹结构中的单独文件中。

视觉对象 json 文件夹结构的屏幕截图。

可以通过以下两种方式之一提高报表开发效率:

  • 在报表之间复制和粘贴视觉对象、页面、书签或文件。
  • 对 PBIR 文件应用手动或编程批处理变更。

与 PBIR 旧格式 (report.json) 不同,PBIR 是一种具有公开文档记录的格式。 此格式允许从非 Power BI 应用程序进行修改。 每个文件都有一个公共 JSON 架构,它记录每个属性,并且会让代码编辑器(例如 Visual Studio Code)在编辑时执行语法验证。 打开时,Power BI Desktop 会验证已更改的 PBIR 文件,以确保成功加载。

如何启用它

PBIR 当前为预览版。 只能使用 Power BI Desktop 创建 PBIR 或将现有的 Power BI 项目文件转换为 PBIR。 必须先在 Power BI Desktop 预览版功能中启用该功能。

  1. 转至“文件”“选项和设置”>“选项”“预览功能”。>>
  2. 选中“使用增强元数据格式(PBIR)存储报表”旁边的框。

在预览版期间,Fabric Git 集成和 Fabric REST API 在导出报表定义时继续使用 PBIR 旧格式 (report.json)。 但是,如果使用 PBIR 格式将报表导入 Fabric,则两个功能都会开始使用 PBIR 格式导出报表定义。 正式发布 (GA) 时,PBIR 将成为默认报表格式。

限制

最初,PBIR 格式存在一些服务限制,例如:

  • 无法使用订阅。
  • 移动视图不会显示在 Power BI 应用中。
  • 不能使用部署管道进行部署。
  • 包含超过500个文件的大型报表在编辑过程中会遇到性能问题(报表查看不受影响),包括:
    • 在 Power BI Desktop 中保存
    • Fabric Git 集成中的同步

有关更多详细信息,请参阅 PBIR 文档

后续步骤