Skip to main content
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：
ClickHouse Cloud 服务连接按钮
选择 HTTPS。连接信息会显示在示例 curl 命令中。
ClickHouse Cloud HTTPS 连接信息
如果你使用的是自管理 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. 例如，下面是在名为 uk_price_paid 的表上运行的一条 SQL 查询，它返回 1995 年到 2022 年间按年份统计的平均成交价格：
5

提出问题

  1. 点击 + New 并选择 Question。请注意，您可以从数据库和表开始构建一个问题。例如，下面的问题是针对 default 数据库中名为 uk_price_paid 的表提出的。这里有一个简单的问题，用于计算 Greater Manchester 县内按城镇分组的平均价格：
  2. 点击 Visualize 按钮，以表格视图查看结果。
  3. 在结果下方，点击 Visualization 按钮，将可视化切换为条形图 (或其他任一可用选项) ：

​
了解更多

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