Databricks 用 Genie Code 批量迁移 Tableau 和 Power BI 报表至 AI/BI
Databricks 的 Genie Code 现已正式支持批量迁移,用 /importBI 指向 Unity Catalog volume 中的整个文件夹,即可一次性把 Tableau 或 Power BI 报表转换为 AI/BI Dashboards。
Databricks:Blog·2026-11-20 00:00· 2 小时前AI 评分46
使用 Genie Code 将仪表板批量迁移到 AI/BI
AI 导读
Databricks 的 Genie Code 现已支持批量迁移:用 /importBI 指向 Unity Catalog volume 中的整个文件夹,即可一次性把 Tableau 或 Power BI 报表转换为 AI/BI Dashboards,该功能已正式可用。
正文 · 原文
在上一篇文章 Migrate Your Dashboards to AI/BI with Genie Code 中,我们介绍了如何使用 Genie Code 中的 /importBI 技能,将单个 Tableau 或 Power BI 报表迁移到 Databricks AI/BI。这种一次处理一个报表的流程非常适合试点——但大多数组织多年来积累了数百个报表,逐个迁移会把一项战略性现代化工作变成长达数月的手动苦工。
仪表板的批量迁移改变了这一局面。现在,你可以让迁移代理指向整个报表文件夹,并在一次运行中将其全部转换为 AI/BI Dashboards——无需再逐个报表启动迁移。
本指南适合以下情况:
- 你已经在某个报表上试用过
/importBI,并准备扩大规模。 - 你有一批积压的 Tableau 或 Power BI 报表——数十或数百个——希望迁移到 Databricks AI/BI。
- 你希望采用可重复、按文件夹进行的迁移流程,而不是逐个报表迁移。
什么是批量迁移?
批量迁移扩展了 Databricks AI/BI 的迁移体验,使你不再一次只导入一个报表,而是可以通过单条命令一起处理多个报表。迁移代理会读取源 BI 文件,在 Databricks 上生成对应的 AI/BI Dashboards,并将它们映射到你指定的目标 catalog 和 schema。
该功能现已正式可用,因此你今天就可以在工作区中使用。开始之前,请确认已在账户和工作区两个层级启用 partner-powered AI features。
为什么重要
对于以 Databricks AI/BI 为标准化的团队来说,批量迁移消除了大规模仪表板迁移中最大的瓶颈:逐个迁移报表带来的大量重复工作。通过一次运行迁移整个 Tableau 或 Power BI 报表文件夹——并将它们直接放入你选定的 catalog 和 schema——你可以将迁移项目从手动积压转变为可重复、按文件夹进行的工作流。
实用的批量迁移操作手册
下面的操作手册端到端介绍了批量迁移。它分为三个阶段:
| 阶段 | 步骤 |
|---|---|
| 准备 | (1) 导出你的 BI 报表 (2) 将它们暂存到 Unity Catalog volume 中 |
| 运行 | (3) 启动批量导入 (4) 选择目标 catalog 和 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 volume 中
将你要迁移的 BI 报告文件放入 Unity Catalog 卷中的某个目录。将它们放在同一个文件夹中,即可批量迁移。批量运行始终从卷中读取文件;直接将文件拖入聊天仅适用于一次性的单报告导入。
3. 从草稿仪表板启动批量导入
在草稿仪表板中打开 Genie Code 并提交:
/importBI <path/to/volume/directory>

上图:在草稿仪表板中对卷目录运行 /importBI。
将命令指向目录(而非单个文件)会触发针对该文件夹中所有报告的批量流程。
如果你更习惯自然语言,像“将 /Volumes/finance/bi/reports 中的每个 Power BI 报告迁移到 AI/BI Dashboards”这样的请求同样有效。
你也可以指定具体文件而非整个文件夹:“将 /Volumes/finance/bi/reports 中的 Tableau 报告 Dashboard1.twb、Dashboard2.twb 迁移到 AI/BI Dashboards”。
最后,你应添加适用于整个批次的指导——例如,要求 Genie Code“仅构建指标视图”。
4. 选择目标目录和架构
代理会识别该批次并列出它在卷中找到的报告,自行将每个 Tableau 工作簿与其配套的数据源文件匹配,若配对不明确会与你确认。随后它会提示你输入目标目录和架构,以便迁移后仪表板的指标视图和 SQL 视图落到正确位置。

上图:Genie Code 列出找到的报告并询问目标目录和架构。
在你检查文件列表并确认后,批量迁移即启动,状态面板会显示每个报告的开始情况。报告会排队并分批处理,每个报告会尽可能复用现有的 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 中匹配筛选条件。对迁移后的仪表板应用相同的筛选条件和日期范围,以便进行同类对比。
- Upload the screenshot to the report's Genie Code conversation and ask it to reconcile:
- “这是原始报表筛选到 2026 年第三季度、EMEA 的截图。对此仪表板应用相同的筛选条件,将每个 KPI 和图表总计与截图进行比较,并列出所有不匹配的值及其可能原因。”
- “对于每个不匹配项,展示该数字背后的指标视图定义或 SQL,并建议修复方法。”
- “检查筛选条件和参数的行为是否与原始报表一致:相同的默认值、相同的交叉筛选,以及对 null 和‘全部’的相同处理方式。”
- 在接受差异之前先调查清楚。差异通常源于数据新鲜度(提取数据与实时 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 提示中通过路径引用它们。 |
| 预计需要通过后续提示进行完善 | • 像对待任何 AI 智能体一样对待 Genie Code——在第一轮之后,再用一次提示来调整图表、筛选器或计算是正常的。 |
| 将完成的指标视图提升到 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 卷,打开草稿仪表板,然后在 Genie Code 中运行 /importBI。
有关分步详细信息,请参阅使用 Genie Code 导入 BI 文件的文档。如果您是 AI/BI 的新手,请从我们之前的文章开始: 使用 Genie Code 将仪表板迁移到 AI/BI。您还应阅读批量迁移产品文档。
常见问题
问:Databricks AI/BI 的批量迁移是什么?
答:批量迁移允许您在单次运行中一起处理多个 Tableau 或 Power BI 报告,而不是一次导入一个报告。迁移智能体会读取您的源 BI 文件,在 Databricks 上生成相应的 AI/BI 仪表板,并将它们映射到您的目标目录和 schema。
问:批量迁移支持哪些文件格式?
A:批量迁移支持来自 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,以便其他仪表板和应用程序可以重用它们。
来源:Databricks:Blog · databricks.com
来源:RadarAI · aihot.news