Metabase 自然语言查数据：从“问一句话“到“出一张图“的完整路径

Metabase 自然语言查数据：从"问一句话"到"出一张图"的完整路径

【免费下载链接】metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:项目地址: https://gitcode.com/GitHub_Trending/me/metabase

Metabase 是一个开源 BI 工具，最大卖点是不用写 SQL：你用自然语言提问，内置的 AI 助手 Metabot 负责把问题变成查询、图表甚至可直接运行的 SQL。如果你们团队的数据在数据库里、但只有工程师才动得了，这个项目值得花十分钟跑一遍。

先看看它能干什么

不用上来就讲架构，直接列能力，每个都配一个真实使用场景：

• 自然语言问答：在聊天面板里问"过去 30 天各类别的订单数"，它会先去翻有没有现成的问题能答，没有就用查询构建器新建一个，最后把图表摆出来。
• SQL 辅助：在 SQL 编辑器里让它"写一段查询"，生成后不会自动执行，留给你审查；查询报错了，点一下按钮它还会尝试替你修复。
• 结果分发：图表存进仪表盘后，可以配置告警和定时订阅，把结果推到邮件或 Slack，数据主动找你而不是你去找数据。

最快跑通：Docker 拉起 + 接一个 AI 密钥

装它比想象中省事，官方文档自称"五分钟搭好"。在有 Docker 的机器上：

docker pull metabase/metabase:latest docker run -d -p 3000:3000 --name metabase metabase/metabase

浏览器打开localhost:3000，完成初始化（选应用数据库、建管理员账号），然后添加你的业务数据源。不想接自己的库也行，可以先加载 Metabase 自带的示例数据库（含 Orders、Products 等示例表），足够把后面所有功能点一遍。

关键一步在管理员设置里：进入 设置 > AI，连接一个 AI 提供商（自托管需要自带 API key）。不做这步，Metabot 图标根本不会出现，后面的能力全部无从谈起。

第一个任务：用一句话生成柱状图

进入路径是 右上角 + 新建 → AI exploration。页面会给出几个建议问题，你也可以直接输入自己的，比如"创建一个柱状图，显示每个产品类别的订单数量"。

Metabot 拿到问题后先检索库中已有内容，复用优先；确属新问题才动手建查询。拿到图表后有两件值得验证的事：点开查看生成的查询逻辑，确认 JOIN 和聚合是否符合预期；如果时间范围或分组方式不对，直接在对话里补一句就能改，不必从头再来。

两个经验值得提前知道：你已经知道要查哪张表，就在问题里明说，结果会稳定很多；换到完全不相关的主题时先重置对话，旧上下文反而会让它跑偏。

第二个任务：让 AI 在 SQL 编辑器里写代码、修 bug

适合稍微进阶的场景。打开 SQL 编辑器、选中数据库后，按 Ctrl+e（Mac 为 Cmd+e）呼出聊天侧栏，说"Write a SQL query that..."，它会生成代码但刻意不执行——给你留出审查窗口，这是设计好的安全边界。

查询报错时，点击Have Metabot fix it让它尝试自动修正。还有一个不依赖聊天面板的快捷姿势：光标停在 SQL 里按 Ctrl/Cmd+Shift+I，输入一句改动描述（比如"加一个今年订单的过滤条件"），它会给出建议补丁，你决定接受还是拒绝。

有个坑要提醒：不指定表名时，Metabot 只会看当前数据库的前 100 张表，涉及更后面的表就可能"编"出表名导致查询失败；另外它用英文提问的效果最可靠。

落到真实工作里：一个电商运营的早晨

设想个常见场景：运营想每天看前一天分品类的销售，以往得等工程师排期跑数，一来一回半天没了。用 Metabase 这样配：先建一个固定仪表盘，通过 AI exploration 让 Metabot 生成分品类销售图表并存进去；管理员还可以指定"自然语言查询的限定集合"，把 Metabot 的检索范围锁在业务相关的集合里，减少它瞎跑；最后给仪表盘配上每日订阅，结果自动进 Slack。

之后每天早上，数据自己出现在工作群里，想看细节能点开下钻，想问新口径就在对话里接着问。没有 SQL，也没有人工搬运。

接下来往哪读

• docs/ai/metabot.md：Metabot 的完整能力清单、使用技巧和已知限制，比任何介绍文章都全。
• docs/ai/settings.md：AI 提供商怎么接、Metabot 的内部与嵌入环境如何独立开关，管理员必读。
• docs/ai/usage-controls.md：限制谁能用 Metabot、设置 token 与消息上限，团队推广前先看它控成本。
• docs/questions/native-editor/writing-sql.md：SQL 编辑器本身的用法，Metabot 的写 SQL、修 SQL 都是建立在这套流程上。
• src/metabase/metabot/：Metabot 的后端实现，想搞清楚它是怎么调用查询构建器的，直接翻源码最直观。

【免费下载链接】metabaseThe easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:项目地址: https://gitcode.com/GitHub_Trending/me/metabase