跳转到主要内容
Metabase 是一款易于使用的开源 UI 工具,可用于查询和分析您的数据。Metabase 是一个 Java 应用程序,只需下载 JAR 文件并使用 java -jar metabase.jar 运行即可。Metabase 通过您下载并放入 plugins 文件夹中的 JDBC 驱动连接到 ClickHouse:

目标

在本指南中,你将使用 Metabase 向 ClickHouse 中的数据提出一些问题,并将答案可视化。其中一个结果会类似这样:

添加一些数据如果你还没有可用的数据集,可以添加一个示例数据集。本指南使用 UK Price Paid 数据集,因此你也可以选择它。同一文档分类下还有其他几个示例可供参考。

1. 收集您的连接信息

要通过 HTTP(S) 连接到 ClickHouse,你需要以下信息: 你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 选择一个服务,然后点击 Connect 选择 HTTPS。连接信息会显示在示例 curl 命令中。 如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。

2. 下载 Metabase 的 ClickHouse 插件

  1. 如果你还没有 plugins 文件夹,请在保存 metabase.jar 的目录下创建一个 plugins 子文件夹。
  2. 该插件是一个名为 clickhouse.metabase-driver.jar 的 JAR 文件。请在 https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest 下载该 JAR 文件的最新版本。
  3. clickhouse.metabase-driver.jar 保存到 plugins 文件夹中。
  4. 启动 (或重启) Metabase,以确保驱动程序正确加载。
  5. 通过 http://hostname:3000 访问 Metabase。首次启动时,你会看到欢迎界面,并需要依次回答一系列问题。如果系统提示你选择数据库,请选择“稍后再添加我的数据”:

3. 将 Metabase 连接到 ClickHouse

  1. 点击右上角的齿轮图标,并选择 Admin Settings,进入您的 Metabase 管理页面
  2. 点击 Add a database。或者,您也可以点击 Databases 选项卡,然后选择 Add database 按钮。
  3. 如果驱动已成功安装,您将在 Database type 的下拉菜单中看到 ClickHouse
  4. 为您的数据库填写一个 Display name。这是 Metabase 中的一项设置,因此您可以使用任意喜欢的名称。
  5. 输入 ClickHouse 数据库的连接详细信息。如果您的 ClickHouse 服务器配置为使用 SSL,请启用安全连接。例如:
  6. 点击 Save 按钮后,Metabase 将扫描数据库中的表。

4. 运行 SQL 查询

  1. 点击右上角的 Exit admin 按钮,退出 Admin settings
  2. 点击右上角的 + New 菜单,可以看到你可以提问、运行 SQL 查询以及创建仪表盘:
  3. 例如,下面这条 SQL 查询在名为 uk_price_paid 的表上运行,返回 1995 年至 2022 年各年的平均成交价格:

5. 提出问题

  1. 点击 + New,然后选择 Question。请注意,你可以从选择数据库和表开始构建问题。例如,下面这个问题针对 default 数据库中名为 uk_price_paid 的表,用于计算 Greater Manchester 郡内各城镇的平均房价:
  2. 点击 Visualize 按钮,以表格视图查看结果。
  3. 在结果下方,点击 Visualization 按钮,将可视化切换为柱状图 (或其他可用选项) :

了解更多

若要进一步了解 Metabase 以及如何构建仪表盘,请访问 Metabase 文档
最后修改于 2026年6月19日