文档大纲

如何从PBIX过渡到PBIR

PBIR 是一种"增强型报表格式"（enhanced report format），其实是为了解决版本控制（Git 等）／多人协作和可维护性问题。相比传统的 .pbix 二进制、整体封装文件，PBIR 将报表内容拆成 JSON + 多个子文件（每个 page / visual / bookmark 等一个文件）。这样更容易 diff、合并、更改，可用代码编辑器（例如 VS Code）查看/编辑。

因此，微软计划把 PBIR 设为默认报表格式。根据其公告，从 2026 年 1 月起，新报告 (Desktop 和 Service 中创建) 将默认使用 PBIR，并且现有报告在编辑保存时也会自动转换为 PBIR。

参考：从 Power BI 文件格式变化看微软的 AI 野心

但你在Power BI中保存或另存文件时，可能会发现并没有项目格式的选项，这又是怎么回事呢？

📌 为什么你还没看到 PBIR

如果你现在还没看到 PBIR，有几个常见原因：

  • PBIR 目前（截至 2025 年）仍处于"预览 / 过渡期"。对普通用户来说，并非自动强制转换。
  • 默认安装/设置可能还没启用"使用增强格式 (PBIR)" — 即使新版 Power BI Desktop，也需要在设置里手动开启。
  • 如果你打开的是旧报表，且尚未编辑／保存过 — 自动转换往往是在"编辑 + 保存"之后才会触发 (针对服务端) 。

🧩 为什么切换 PBIR，保存时的选项是 PBIP？

PBIR 不能单独存在，它必须属于一个 PBIP 项目。

微软的逻辑是：

  1. PBIR = 报表（report）内容的新格式
  2. TMDL = 语义模型（dataset）内容的新格式
  3. PBIP = 把 PBIR + TMDL + 所有 JSON 组装成一个完整项目

所以当你启用 PBIR 后：

  • 保存报表，不再生成 .pbix（封装文件）
  • 而是生成 .pbip（项目文件）
  • PBIP 项目内部包含了 report.pbir或者definition.pbir
    这才是你真正的 PBIR

因此，"保存 = PBIP"，是正常现象。

🔧 如果想启用 / 使用 PBIR — 应该怎么做

如果你想在自己的环境 (Desktop + 本地) 中启用 PBIR，可以这样操作：

① 打开 Power BI Desktop

不需要最新版也可以，但建议 2024 下半年以后的版本。

② 打开"选项和设置"

左上角菜单：
文件 → 选项和设置 → 选项

③ 找到"预览功能（Preview features）"

在左侧菜单中找到 "Preview features / 预览功能"。

④ 勾选以下选项（关键）

请确保启用这两个：

  • ✔ 使用增强报表格式（PBIR） / Use enhanced report format (PBIR)
  • ✔ 启用 PBIP 项目模式（也叫 "Power BI Project"）

⚠️ 如果你的版本里只有一个叫 "Power BI Project / PBIP"的选项，也勾选即可，因为 PBIR 是 PBIP 的报表部分。

⑤ 重新启动 Power BI Desktop

这是必须的，否则不会出现 PBIR 选项。

简言之，只开启这个预览功能 + 使用 PBIP，就能得到 PBIR 格式。

🔄 如何把已有的.PBIX/ 旧报表转为 PBIR

启用功能后，你必须保存成 PBIP（项目模式），才能生成 PBIR。

① 打开你原来的 .pbix 报表

双击文件即可。

② 点击"文件 → 另存为（Save As）"

在保存类型中，你会看到一个新增选项：

  • Power BI 项目 (.pbip)

③ 选择保存为 .pbip

这一步非常关键：

当你保存为 .pbip 后，Power BI 会自动创建一个文件夹结构：

 /你的报表文件夹
    |-- report.pbir      ← 这就是新格式
    |-- dataset.tmdl     ← 你的数据模型（可文本化）
    |-- <其他 JSON 文件>

你保存的 .pbip 只是一个"入口文件"，真正的内容都在旁边的文件夹里。

④ 保存后，你的旧 PBIX 就成功转换为 PBIR 结构了

你已经获得：

  • PBIR（报表格式）
  • TMDL（语义模型格式）
  • 可读 JSON（支持 Git、比较差异等）

⭐ PBIP/PBIR 的使用方式（你会看到的行为变化）

① 打开报表时，不再是一个单独文件，而是一个"项目"

以后你打开的是 .pbip，它会自动打开包含 PBIR、TMDL 的整个项目。

② PBIR 文件本身不能单独打开

必须和 PBIP 一起用。

③ 文件夹结构是未来微软推荐的开发方式

非常适合团队、多开发者、Git 管理。

⭐ 第 4 部分：注意事项（非常重要）

⚠️ 1. PBIR 仍处于逐步推广阶段

某些功能暂时不支持：

  • 手机布局（Phone layout）
  • 部分旧插件
  • 某些第三方工具

如果遇到异常，先回到 PBIX 格式。

⚠️ 2. PBIP 项目不等同于 PBIX

它包含多个文件，不是单个"整体打包"。

如果你要把报表交给别人，必须把整个文件夹一起打包成 zip 分享。

⚠️ 3. PBIR 生成后，不建议再回退为 PBIX

虽然可以恢复（用"导出 PBIX"），但你会丢失结构化文件的优势。

要么全团队一起换，要么继续保留 PBIX。

⚠️ 4. Power BI Service（网页版）会逐步自动转换

微软官方计划在 2026 年开始 强制 PBIR 成为默认报表格式，不需要手动干预。

⚠️ 5. 与 Git / Source Control 结合最有价值

PBIR 主要价值是：

  • 可版本控制（JSON）
  • 可比较差异（Diff）
  • 团队协作更安全

阅读量： 379

网站备案号：沪ICP备2025137870号