连接 Metabase 到 ClickHouse

Metabase 是一款易于使用的开源 UI 工具，用于询问关于您数据的问题。Metabase 是一个 Java 应用程序，可以通过简单地下载 JAR 文件并使用 java -jar metabase.jar 运行它来运行。Metabase 使用 JDBC 驱动程序连接到 ClickHouse，您可以下载该驱动程序并将其放在 plugins 文件夹中

目标

在本指南中，您将使用 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 以及如何构建仪表板的信息。

相关内容

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