将 Metabase 连接到 ClickHouse

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

你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 选择一个服务，然后点击 Connect：

选择 HTTPS。连接信息会显示在示例 curl 命令中。

如果你使用的是自管理 ClickHouse，则连接信息由你的 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。首次启动时，您会看到欢迎界面，并需要依次回答一系列问题。如果系统提示您选择数据库，请选择“稍后再添加我的数据”：

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 将扫描数据库中的表。

1. 点击右上角的 Exit admin 按钮，退出 Admin settings。

2. 点击右上角的 + New 菜单，您会看到可以提出问题、运行 SQL 查询以及构建仪表盘：

   

3. 例如，下面是在名为 uk_price_paid 的表上运行的一条 SQL 查询，它返回 1995 年到 2022 年间按年份统计的平均成交价格：

   

1. 点击 + New 并选择 Question。请注意，您可以从数据库和表开始构建一个问题。例如，下面的问题是针对 default 数据库中名为 uk_price_paid 的表提出的。这里有一个简单的问题，用于计算 Greater Manchester 县内按城镇分组的平均价格：

   

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

   

3. 在结果下方，点击 Visualization 按钮，将可视化切换为条形图 (或其他任一可用选项) ：