- 使用一条命令迁移整个报表文件夹。将 Tableau 或 Power BI 文件放入 Unity Catalog 卷,打开一个仪表板草稿,然后在 Genie Code 中运行 /importBI。智能体会查找每一份报表,将工作簿与其数据源配对,并在你选择的目录和 schema 中创建 AI/BI 仪表板和指标视图。
- 在批处理运行期间跟踪进度。报表会进入队列并分批处理,并尽可能复用现有的 Unity Catalog 表、视图和指标视图。状态卡片会将每份报表显示为“已排队”“运行中”或“已完成”,你可以停止单份报表或整个批处理。
- 在迁移过程中构建可复用的语义层。将迁移期间创建的指标视图提升至 Unity Catalog,或预先要求创建 Unity Catalog 指标视图。之后的迁移、其他仪表板、Genie 智能体和笔记本便可复用相同的受治理定义。
在上一篇文章中, 使用 Genie Code 将仪表板迁移至 AI/BI,我们介绍了如何借助 Genie Code 中的 /importBI 技能,将单个 Tableau 或 Power BI 报表迁移至 Databricks AI/BI。这种一次迁移一份报表的流程非常适合试点,但大多数组织都积累了数百份历经多年创建的报表,逐一迁移会让战略性现代化工作变成持续数月的手动苦差事。
仪表板批量迁移改变了这一局面。现在,你可以让迁移智能体处理整个报表文件夹,并在一次运行中将它们转换为 AI/BI 仪表板 ,再也不必逐份启动报表迁移。
如果你符合以下情况,本指南正适合你:
- 你已经在一两份报表上试用过
/importBI,现在准备扩大迁移规模。 - 你积压了数十乃至数百份 Tableau 或 Power BI 报表,希望将它们迁移至 Databricks AI/BI。
- 你希望采用可重复、逐文件夹进行的迁移流程,而不是逐份报表迁移。
什么是批量迁移?
批量迁移扩展了 Databricks AI/BI 迁移体验,让你不再需要一次导入一份报表,而是可以通过一条命令同时处理多份报表。迁移智能体会读取源 BI 文件,在 Databricks 上生成相应的 AI/BI 仪表板,并将其映射到你指定的目标目录和 schema。
此功能现已正式可用,因此你现在就能在工作区中使用。开始之前,请检查账户和工作区层面是否均已启用 合作伙伴支持的 AI 功能 。
为何重要
对于正在统一采用 Databricks AI/BI 的团队,批量迁移消除了大规模仪表板迁移中最大的瓶颈:逐份迁移报表带来的大量重复工作。通过一次运行迁移整个 Tableau 或 Power BI 报表文件夹,并将其直接存放到你选择的目录和 schema 中,你可以将迁移项目从手动处理积压任务转变为可重复的逐文件夹工作流。
实用的批量迁移操作指南
下面的操作指南将带你端到端完成一次批量迁移。整个流程分为三个阶段:
| 阶段 | 步骤 |
|---|---|
| 准备 | (1) 导出 BI 报表 (2) 将其暂存到 Unity Catalog 卷中 |
| 运行 | (3) 启动批量导入 (4) 选择目标目录和 schema (5) 跟踪批处理 |
| 检查与完善 | (6) 检查每份报表 (7) 按照迁移计划操作 (8) 优化和润色 |
1. 导出 BI 报表
将要迁移的每份 Tableau 或 Power BI 报表导出为受支持的文件类型,包括 .twb、.twbx、.tds、.tdsx、.pbit 或 .tmdl。 Tableau 导出文档 和 Power BI 报表模板 指南将引导你完成导出。
提示:要处理连接到已发布数据源的 Tableau 工作簿吗?也请导出该数据源(.tds 或 .tdsx),并将其放在工作簿旁边。
2. 将文件暂存到 Unity Catalog 卷中
将要迁移的 BI 报表文件放入 Unity Catalog 卷内的一个 目录。将它们集中放在同一文件夹中,即可进行批量迁移。批量运行始终从卷中获取文件;将文件直接拖入聊天仅适用于临时的单报表导入。
3. 从仪表板草稿启动批量导入
在仪表板草稿中打开 Genie Code,然后提交:
/importBI <path/to/volume/directory>

上图:从仪表板草稿中对卷目录运行 /importBI。
将命令指向目录而非单个文件,会对该文件夹中的所有报表触发批量流程。
如果你更喜欢使用自然语言,也可以提出类似“将 /Volumes/finance/bi/reports 中的所有 Power BI 报表迁移为 AI/BI 仪表板”的请求,效果完全相同。
你也可以指定具体文件,而不是整个文件夹:“将 /Volumes/finance/bi/reports 中的 Tableau 报表 Dashboard1.twb、Dashboard2.twb 迁移为 AI/BI 仪表板”。
最后,你还应添加适用于整个批处理的指导,例如要求 Genie Code“仅构建指标视图”。
4. 选择目标目录和 schema
智能体会识别出这是一个批处理任务,列出在卷中找到的报表,自行将每个 Tableau 工作簿与配套的数据源文件匹配;如果配对关系不明确,则会向你确认。随后,它会提示你指定目标目录和 schema,确保迁移后仪表板的指标视图和 SQL 视图存放在正确的位置。

上图:Genie Code 列出找到的报表,并询问目标目录和 schema。
检查文件列表并批准后,批量迁移便会启动,状态面板会显示每份报表的启动情况。报表会进入队列,每次处理少量报表;在创建新对象之前,每份报表都会尽可能复用现有的 Unity Catalog 表和视图。
注意:关于单次批量导入所支持文件数量和大小的当前限制,请始终参阅公共文档中的 /importBI.
5. 跟踪批处理
聊天中的状态卡片会持续汇总批处理进度,并将每份报表标记为“已排队”(尚未开始)、“运行中”或“已完成”(会话已结束)。你可以在同一卡片中停止单份报表,也可以终止所有仍在执行的任务。

上图:状态卡片跟踪批处理中的每份报表。
由于每份报表都在各自的后台任务中运行,因此无需一直打开标签页——你可以随时回到 Genie Code 历史记录中的原始聊天,查看批处理进度。
6. 检查每份报表
状态卡片上的每个文件名都链接到该报表自己的 Genie Code 对话,并会在单独的标签页中打开。如果某次运行暂停并提出问题,请在那里回答,迁移便会从中断处继续。

上图:一次暂停并等待输入的运行。在本例中,询问的是工作簿背后的已发布数据源。
7. 按照迁移计划执行
与单文件 /importBI 迁移一样,每份报表都会经历 Genie Code 的规划阶段,例如解析和评估工作簿、梳理语义层、创建指标视图、构建仪表板页面以及验证迁移结果。

上图:单份报表的迁移计划,按步骤跟踪。
8. 优化和完善
计划执行完成后,你可以查看迁移生成的最终 AI/BI 仪表板。你还可以通过后续的 Genie Code 提示词进一步增强或自定义仪表板。Genie Code 的每次响应都可以作为单个步骤撤销,因此可以放心尝试;你甚至可以让 Genie Code 美化仪表板的外观和体验。

上图:批量迁移生成的最终 AI/BI 仪表板。
9. 与原始仪表板进行核验
在停用源报表之前,请检查迁移后的仪表板是否能给出与原始报表相同的答案。
- 截取一张参考截图。 在 Tableau 或 Power BI 中,设置一个已知的筛选状态(例如最近一个完整季度和某个区域),然后截取一张能够清晰看出 KPI 卡片、汇总值和几张关键图表的截图。
- 在 AI/BI 中匹配筛选条件。 对迁移后的仪表板应用相同的筛选条件和日期范围,以便在一致的条件下进行比较。
- 将截图上传到该报表的 Genie Code 对话中,并让它进行核对:
- “这是原始报表筛选到 2026 年第三季度、EMEA 地区后的截图。请对这个仪表板应用相同的筛选条件,将每个 KPI 和图表汇总值与截图进行比较,并列出所有不匹配的数值及其可能原因。”
- “对于每处不匹配,请显示该数值背后的指标视图定义或 SQL,并提出修复建议。”
- “检查筛选器和参数的行为是否与原始报表一致:默认值相同、交叉筛选行为相同,并且对空值和‘全部’的处理方式相同。”
- 在接受差异之前先调查原因。 差异通常源于数据新鲜度(例如将数据提取与实时 Unity Catalog 表进行比较)、默认筛选条件不同,或计算语义不同,例如去重计数、详细级别表达式或时间智能。这些差异并不一定意味着迁移出错。
- 记录验收结果。 对于业务关键型仪表板,在将用户切换到新仪表板之前,请保留截图和核对结果作为凭证。
提示: 如果你已通过只读 MCP 连接接入 Tableau 或 Power BI(请参阅下方速查表),Genie Code 可以直接对照实时报表核验数值,而不必从截图中读取数据。
最佳实践速查表
在运行前充分做好设置, /importBI 以便首次迁移就获得尽可能忠实的结果:
| 最佳实践 | 详细说明 |
|---|---|
| 通过 MCP 连接源 BI 工具(可选/推荐) | • 为 Tableau 或 Power BI 设置只读 MCP 连接,使 Genie Code 能够以实时报表作为事实依据,对照原始报表验证结果,而不是仅依赖导出的文件,从而显著提高准确性。
|
| 上传共享或已发布的数据源定义 | • 在 Tableau 中,将所有已发布的数据源分别导出为独立的 .tds 文件;在 Power BI 中,将共享数据模型导出为 .pbit 文件。将这些文件与报表一同上传,以便智能体查看完整的语义层。 |
| 确保 Databricks 可以访问底层数据 | • 迁移后的仪表板会映射到 Unity Catalog 表(通过 Lakeflow Connect、Lakehouse Federation 或现有 UC 表)。
示例: “此报表的源表位于 dev.finance schema 中” “使用 prod.finance.table1、prod.finance.table2 和 prod.finance.mv_revenue 作为此报表的数据源” |
| 添加原始仪表板的截图 | • 将“迁移前”的截图上传到 Genie Code 聊天中,可以显著提高视觉效果和布局的还原度。 提示: 迁移前,请将原始仪表板的截图保存到 Unity Catalog 卷中,以便在 Genie Code 提示词里通过路径引用这些截图。 |
| 做好通过后续提示词优化的准备 | • 将 Genie Code 视为其他任何 AI 智能体——首次处理后再用第二条提示词调整图表、筛选器或计算逻辑是正常情况。 |
| 将最终确定的指标视图发布到 Unity Catalog | • 默认情况下,Tableau 导入会生成仪表板范围内的本地指标视图,而 Power BI 导入会生成 Unity Catalog 指标视图。
|
| 查看文档中记录的文件限制 | • 文件数量和大小限制可能发生变化,因此请始终参阅 公开的 /importBI 文档 ,了解当前限制。
|
| 信任结果前逐一检查 | • “已完成”表示运行已经结束,并不意味着每个可视化结果都已最终定稿。关闭会话前,请验证每份报表。 |
更多资源
- AI/BI 和 Genie One 发行说明(2026):介绍 AI/BI 的最新功能和改进,包括 /importBI 和 Genie Code 在仪表板创作方面的更新。
- Unity Catalog 语义模式:经过测试的 Unity Catalog 指标视图构建参考模式,包括时间智能、半可加度量值、排名、货币换算和细分,可用于优化或发布迁移所创建的指标视图。
结论
将数百份 Tableau 或 Power BI 报表迁移到 Databricks AI/BI,不再意味着要进行数百次单独迁移。借助批量迁移,你只需准备一次报表文件夹,运行一条 /importBI 命令,然后让 Genie Code 在后台处理整批任务,同时你可以检查并优化每项结果。
如果你正在规划 BI 现代化工作,请将报表文件夹上传到 Unity Catalog 卷,并从草稿仪表板中尝试 /importBI ,亲自体验批量迁移。
准备好将 Tableau 和 Power BI 报表迁移到 AI/BI 了吗?
如果你已准备好开始,只需将报表文件放入 Unity Catalog 卷,打开一个草稿仪表板,然后运行 /importBI (在 Genie Code 中)。
有关分步说明,请参阅关于 使用 Genie Code 导入 BI 文件的文档。如果你刚开始使用 AI/BI,请先阅读我们之前的文章: 使用 Genie Code 将仪表板迁移到 AI/BI。你还应阅读 批量迁移产品文档.
常见问题
问:什么是 Databricks AI/BI 批量迁移?
答:批量迁移允许你在一次运行中同时处理多份 Tableau 或 Power BI 报表,而不必逐份导入。迁移智能体会读取源 BI 文件,在 Databricks 上生成相应的 AI/BI 仪表板,并将其映射到目标目录和 schema。
问:批量迁移支持哪些文件格式?
答:批量迁移支持来自 Tableau 和 Power BI 报表的 .twb、.twbx、.tds、.tdsx、.pbit 和 .tmdl 文件格式。
问:进行批量迁移时,需要将 BI 报表文件存储在哪里?
答:请将所有要迁移的 BI 报表文件存储在 Unity Catalog 卷内的一个目录中。然后,可以让 /importBI 命令指向该目录,以触发批量迁移工作流。
问:如何在 Genie Code 中启动批量迁移?
答:在草稿仪表板中打开 Genie Code,然后提交命令 /importBI <path/to/volume/directory>。你也可以使用自然语言,例如:“将 /Volumes/finance/bi/reports 中的每份 Power BI 报表迁移为 AI/BI 仪表板。”
问:批量迁移完成后,我该做什么?
答:完成后,你可以检查每个已迁移的仪表板,将其与原始报表进行比较,并使用 Genie Code 提示词优化或自定义仪表板。你还可以将本地指标视图发布到 Unity Catalog,以便其他仪表板和应用程序复用。
相关标签:在收件箱中获取最新文章
订阅我们的博客,让最新文章直接发送到你的收件箱。
AI 热点