将 Metabase 连接到 ClickHouse
Metabase 是一个易于使用的开源 UI 工具,用于询问有关数据的问题。Metabase 是一个 Java 应用程序,可以通过简单地 下载 JAR 文件 并使用 java -jar metabase.jar
运行。Metabase 使用 JDBC 驱动程序连接到 ClickHouse,您需要下载并将其放入 plugins
文件夹中:
目标
在本指南中,您将使用 Metabase 提出一些关于 ClickHouse 数据的问题并可视化答案。 其中一个答案将如下所示:

如果您没有可用的数据集,可以添加一些示例。本指南使用 UK Price Paid 数据集,因此您可以选择该数据集。在同一文档类别中还有其他几个可以查看的示例。
1. 收集连接详细信息
To connect to ClickHouse with HTTP(S) you need this information:
-
The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.
-
The DATABASE NAME: out of the box, there is a database named
default
, use the name of the database that you want to connect to. -
The USERNAME and PASSWORD: out of the box, the username is
default
. Use the username appropriate for your use case.
The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

Choose HTTPS, and the details are available in an example curl
command.

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.
ClickHouseにHTTP(S)で接続するには、次の情報が必要です:
-
HOSTとPORT: 通常、ポートはTLSを使用する場合は8443、TLSを使用しない場合は8123です。
-
DATABASE NAME: デフォルトでは、
default
という名前のデータベースがあります。接続したいデータベースの名前を使用してください。 -
USERNAMEとPASSWORD: デフォルトでは、ユーザー名は
default
です。ご利用のケースに適したユーザー名を使用してください。
ClickHouse Cloudサービスの詳細はClickHouse Cloudコンソールで確認できます。接続するサービスを選択し、Connectをクリックします:

HTTPSを選択すると、詳細が例のcurl
コマンドで提供されます。

セルフマネージドのClickHouseを使用している場合、接続の詳細はClickHouseの管理者によって設定されます。
2. 下载 ClickHouse 插件以用于 Metabase
-
如果您没有
plugins
文件夹,请在保存metabase.jar
的位置创建一个子文件夹。 -
插件是一个名为
clickhouse.metabase-driver.jar
的 JAR 文件。请在 https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest 下载最新版本的 JAR 文件。 -
将
clickhouse.metabase-driver.jar
保存到您的plugins
文件夹中。 -
启动(或重启)Metabase,以便驱动程序能够正确加载。
-
在 http://hostname:3000 访问 Metabase。在初次启动时,您将看到欢迎屏幕,并需要完成一系列问题。如果提示选择数据库,请选择 "我稍后将添加数据":
3. 将 Metabase 连接到 ClickHouse
-
点击右上角的齿轮图标并选择 管理设置,以访问您的 Metabase 管理页面。
-
点击 添加数据库。或者,您可以点击 数据库 标签并选择 添加数据库 按钮。
-
如果您的驱动程序安装成功,您将在 数据库类型 的下拉菜单中看到 ClickHouse:
-
给您的数据库一个 显示名称,这是一个 Metabase 设置 - 因此可以使用您喜欢的名称。
-
输入 ClickHouse 数据库的连接详细信息。如果您的 ClickHouse 服务器配置为使用 SSL,请启用安全连接。例如:
-
点击 保存 按钮,Metabase 将扫描您的数据库以查找表。
4. 运行 SQL 查询
-
点击右上角的 退出管理员 按钮退出 管理设置。
-
在右上角,点击 + 新建 菜单,注意您可以询问问题、运行 SQL 查询和构建仪表板:
-
例如,以下是在名为
uk_price_paid
的表上运行的 SQL 查询,返回 1995 年至 2022 年的平均价格:
5. 提出一个问题
-
点击 + 新建 并选择 问题。注意您可以通过从数据库和表开始构建问题。例如,以下问题是向
default
数据库中的名为uk_price_paid
的表提出的。这个简单的问题计算了在大曼彻斯特郡内按城镇划分的平均价格: -
点击 可视化 按钮查看表格视图中的结果。
-
在结果下方,点击 可视化 按钮将可视化转换为条形图(或其他任何可用选项):
了解更多
通过 访问 Metabase 文档,您可以找到更多有关 Metabase 及构建仪表板的信息。