跳转至

Metabase 仪表盘搭建文档包使用总览

先理解三个概念

在 Metabase 里不要一开始就找地方粘贴整套仪表盘。正确关系是：

一段 SQL -> 保存成一个 Question -> 多个 Question 放进一个 Dashboard
  • Question：一个问题，也就是一张图、一个指标卡、一个表格。SQL 是粘贴在这里的。
  • Dashboard：仪表盘，只负责摆放已经保存好的 Question。创建 Dashboard 时通常不粘贴 SQL。
  • Collection：文件夹，用来存放 Question 和 Dashboard。

所以“粘贴本文档中的 SQL”的意思是：打开某个仪表盘文档，找到你要做的卡片或图表下面的 ``sql 代码块，把这一整段 SQL 粘贴到New -> SQL query` 的编辑器里。

当前状态

  • Metabase 已连接 MySQL 数据库：lz_group6_v4
  • 当前推荐使用只读用户：lz_group6_bi
  • 数据版本：v4_1_20260716
  • 数据范围：淘宝用户行为数据，2017-11-25 至 2017-12-03
  • 底层表和字段保持英文，Metabase 展示层使用中文标题、中文字段别名和中文说明。

不要在文档、截图、群聊里传播数据库密码、服务器密码、宝塔密码或 Metabase 管理员密码。

文档应该怎么读

建议按这个顺序使用：

  1. 先读本文件，理解 Question 和 Dashboard 的关系。
  2. 读 01-中文显示与字段命名.md，知道为什么字段是英文、看板可以是中文。
  3. 选择一个要搭建的仪表盘文档，例如 02-答辩总览仪表盘.md。
  4. 在该文档里按“卡片1、卡片2、图表1、表格1”的顺序，一个 SQL 代码块创建一个 Question。
  5. 所有 Question 保存后，再新建 Dashboard，把这些 Question 逐个添加进去。
  6. 参考 08-创建顺序与排版清单.md 调整布局。
  7. 如果是第一次做，直接照 10-从零搭建一个仪表盘详细示例.md 操作。

新建一个 Question 的具体步骤

以下步骤用于创建“一张图”或“一个指标卡”。

  1. 进入 Metabase 首页。
  2. 点击右上角 + New。
  3. 选择 SQL query。
  4. 在页面上方或左上方选择数据库，选择 v4 数据源，名称通常类似“览众第6组 V4”。
  5. 打开本地文档，例如 02-答辩总览仪表盘.md。
  6. 找到你要创建的图表标题，例如 卡片1：清洗后记录数。
  7. 复制这个标题下面的完整 SQL 代码块，只复制 SELECT ...; 这一段，不复制 ```sql 标记。
  8. 回到 Metabase 的 SQL 编辑器，把 SQL 粘贴进去。
  9. 点击运行按钮，确认能看到结果。
  10. 选择可视化类型。中文界面里按中文名称选择，例如“指标”“折线图”“柱状图”“表格”；文档里括号中的英文是 Metabase 英文界面的叫法。
  11. 调整图表标题和字段显示。
  12. 点击 Save。
  13. 保存到自己的 Collection 或项目公共 Collection。

示例：如果你要做答辩总览的第一个指标卡，就打开 02-答辩总览仪表盘.md，找到：

## 卡片1：清洗后记录数

然后复制它下面的 SQL，保存成一个 Question，建议命名为：

答辩总览-卡片1-清洗后记录数

新建一个 Dashboard 的具体步骤

以下步骤用于创建“一整个仪表盘页面”。

  1. 点击右上角 + New。
  2. 选择 Dashboard。
  3. 输入仪表盘名称，例如：
答辩总览
  1. 保存到对应 Collection。
  2. 打开这个 Dashboard。
  3. 点击 Add a card。
  4. 搜索刚才保存的 Question，例如 答辩总览-卡片1-清洗后记录数。
  5. 选择该 Question，把它添加到 Dashboard。
  6. 重复添加其他 Question。
  7. 拖动卡片调整大小和位置。
  8. 点击保存或退出编辑，确认仪表盘能正常打开。

注意：创建 Dashboard 时不粘贴 SQL。SQL 已经在创建 Question 时粘贴并保存过了。

建议创建的仪表盘

仪表盘 对应文档 用途
答辩总览 02-答辩总览仪表盘.md 最终演示首页
经营总览 03-经营总览仪表盘.md 全局规模、KPI、数据质量
流量与时段 04-流量与时段仪表盘.md 日期趋势、小时热区
类目与商品 05-类目与商品仪表盘.md 类目排行、机会、商品长尾
用户与转化 06-用户与转化仪表盘.md 用户分层、复购、漏斗、流失
推荐与证据 07-推荐与证据仪表盘.md Top-5 推荐、覆盖率、样例
高级联动与窗口分析 09-高级联动与窗口分析.md 日期窗口、类目、用户分层组合

每个仪表盘文档怎么看

每个仪表盘文档基本都是这个结构：

目标
布局建议
卡片1：...
SQL
卡片2：...
SQL
图表1：...
SQL
表格1：...
SQL
讲解词或口径

操作时按标题逐个做：

卡片1 -> 复制其 SQL -> 新建 Question -> 保存
卡片2 -> 复制其 SQL -> 新建 Question -> 保存
图表1 -> 复制其 SQL -> 新建 Question -> 保存
表格1 -> 复制其 SQL -> 新建 Question -> 保存
最后 -> 新建 Dashboard -> Add a card -> 加入这些 Question

命名建议

Question 命名：

仪表盘名-卡片或图表编号-图表主题

示例：

答辩总览-卡片1-清洗后记录数
答辩总览-图表1-每日行为趋势
流量与时段-图表5-日期小时浏览热力
推荐与证据-参数查询-指定商品Top5推荐

Dashboard 命名：

答辩总览
经营总览
流量与时段
类目与商品
用户与转化
推荐与证据

组员个人看板可以加姓名：

张三-流量与时段-个人看板

可视化类型中英文对照

如果 Metabase 页面是中文界面，按下表选择。文档里出现英文时，看这一张表即可。

文档英文 中文界面常见名称 适合什么内容
Number 指标 / 数字 单个 KPI，例如记录数、用户数、覆盖率
Line 折线图 按日期或小时变化的趋势
Bar 柱状图 / 条形图 Top 排名、分组对比
Table 表格 明细、证据、数据质量清单
Pivot table 数据透视表 / 透视表 日期乘小时、分组交叉表
Heatmap 热力图 小时热区、日期小时热力
Pie 饼图 占比分布，类别不要太多
Scatter 散点图 两个数值指标之间的关系
Funnel 漏斗图 浏览、收藏、加购、购买等阶段转化

如果找不到完全一样的中文名称，按用途选择即可。例如文档写 Bar，中文界面里看到“柱状图”或“条形图”都可以；排名类图表优先选横向条形图，趋势类图表优先选折线图。

中文展示原则

SQL 查询结果列建议使用中文别名，例如：

SELECT
  date AS `日期`,
  pv_count AS `浏览量`
FROM daily_metrics;

中文别名会直接变成图表里的字段名。底层数据库字段仍然是英文，不需要也不应该改数据库表结构。

不建议放进 Metabase 的内容

  • 原始 UserBehavior 大 CSV。
  • clean/、temp/、DuckDB 临时库。
  • 没有口径说明的模拟 GMV 或虚构商品名称。
  • 一次性展示 recommendations 全表。推荐明细超过 2000 万行，应使用条件查询或样例表。