将 Metabase 连接到 ClickHouse

Metabase 是一款易于使用的开源 UI 工具，用于询问有关数据的问题。Metabase 是一个 Java 应用程序，只需下载 JAR 文件并使用 java -jar metabase.jar 运行即可。Metabase 使用您下载并放置在 plugins 文件夹中的 JDBC 驱动程序连接到 ClickHouse。

目标

在本指南中，您将使用 Metabase 对 ClickHouse 数据提出一些问题并可视化答案。其中一个答案如下所示

添加一些数据

如果您没有要使用的数据集，您可以添加其中一个示例。本指南使用英国房价数据集，因此您可以选择该数据集。在同一文档类别中还有其他几个数据集可以查看。

1. 收集连接详细信息

要使用 HTTP(S) 连接到 ClickHouse，您需要以下信息

• 主机和端口：通常，使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。

• 数据库名称：默认情况下，有一个名为 default 的数据库，请使用要连接到的数据库的名称。

• 用户名和密码：默认情况下，用户名为 default。请使用适合您用例的用户名。

您的 ClickHouse Cloud 服务的详细信息可在 ClickHouse Cloud 控制台中找到。选择您要连接的服务并点击**连接**

选择**HTTPS**，详细信息可在 curl 命令示例中找到。

如果您使用的是自托管 ClickHouse，则连接详细信息由您的 ClickHouse 管理员设置。

2. 下载用于 Metabase 的 ClickHouse 插件

1. 如果您没有 plugins 文件夹，请将其作为保存 metabase.jar 的文件夹的子文件夹创建。

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. 点击右上角的齿轮图标，然后选择**管理设置**以访问您的Metabase 管理页面。

2. 点击**添加数据库**。或者，您可以点击**数据库**选项卡并选择**添加数据库**按钮。

3. 如果您的驱动程序安装成功，您将在**数据库类型**的下拉菜单中看到**ClickHouse**

   

4. 为您的数据库指定一个**显示名称**，这是一个 Metabase 设置 - 因此可以使用任何您喜欢的名称。

5. 输入 ClickHouse 数据库的连接详细信息。如果您的 ClickHouse 服务器配置为使用 SSL，请启用安全连接。例如

   

6. 点击**保存**按钮，Metabase 将扫描您的数据库以查找表。

4. 运行 SQL 查询

1. 点击右上角的**退出管理**按钮退出**管理设置**。

2. 在右上角，点击**+ 新建**菜单，您会注意到您可以提出问题、运行 SQL 查询和构建仪表板

   

3. 例如，以下是在名为 uk_price_paid 的表上运行的 SQL 查询，它返回从 1995 年到 2022 年按年份计算的平均支付价格

   

5. 提出问题

1. 点击**+ 新建**并选择**问题**。请注意，您可以通过从数据库和表开始构建问题。例如，以下问题是对 default 数据库中名为 uk_price_paid 的表提出的。这是一个简单的查询，计算大曼彻斯特郡内每个城镇的平均价格

   

2. 点击**可视化**按钮以表格形式查看结果。

   

3. 在结果下方，点击**可视化**按钮将可视化更改为条形图（或任何其他可用选项）

   

了解更多

通过访问 Metabase 文档，查找有关 Metabase 和如何构建仪表板的更多信息。

相关内容

• 博客：使用 ClickHouse 可视化数据 - 第 3 部分 - Metabase