跳到主要内容
跳到主要内容

将 Metabase 连接到 ClickHouse

Community Maintained

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

目标​

在本指南中，您将使用 Metabase 查询 ClickHouse 数据，并可视化答案。 驱动结果之一将如下所示：

添加一些数据

如果您没有数据集可以使用，您可以添加一个示例。 本指南使用的是 UK Price Paid 数据集，您可以选择该数据集。 在同一文档类别中还有其他几个供您查看。

1. 收集连接详情​

要通过 HTTP(S) 连接到 ClickHouse，您需要以下信息：

  • HOST 和 PORT：通常情况下，使用 TLS 时端口为 8443，不使用 TLS 时端口为 8123。

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

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

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

选择 HTTPS，并且详细信息可以在一个示例 curl 命令中找到。

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

2. 下载 ClickHouse 的 Metabase 插件​

  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. 访问 Metabase，地址为 http://hostname:3000。 在初始启动时，您会看到一个欢迎界面，并需要逐步完成一系列问题的回答。 如果提示选择数据库，请选择 "I'll add my data later":

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 表提问的。 这是一个简单的问题，计算大曼彻斯特县内按城镇的平均价格：

  2. 点击 Visualize 按钮以查看表格视图中的结果。

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

了解更多​

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