java -jar metabase.jar 运行即可。Metabase 通过您下载并放入 plugins 文件夹中的 JDBC 驱动连接到 ClickHouse:
目标
1. 收集您的连接信息
你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。
选择一个服务,然后点击 Connect:
选择 HTTPS。连接信息会显示在示例
curl 命令中。
如果你使用的是自管理 ClickHouse,则连接信息由你的 ClickHouse 管理员配置。
2. 下载 Metabase 的 ClickHouse 插件
-
如果你还没有
plugins文件夹,请在保存metabase.jar的目录下创建一个plugins子文件夹。 -
该插件是一个名为
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
- 点击右上角的齿轮图标,并选择 Admin Settings,进入您的 Metabase 管理页面。
- 点击 Add a database。或者,您也可以点击 Databases 选项卡,然后选择 Add database 按钮。
- 如果驱动已成功安装,您将在 Database type 的下拉菜单中看到 ClickHouse:
- 为您的数据库填写一个 Display name。这是 Metabase 中的一项设置,因此您可以使用任意喜欢的名称。
- 输入 ClickHouse 数据库的连接详细信息。如果您的 ClickHouse 服务器配置为使用 SSL,请启用安全连接。例如:
- 点击 Save 按钮后,Metabase 将扫描数据库中的表。
4. 运行 SQL 查询
- 点击右上角的 Exit admin 按钮,退出 Admin settings。
- 点击右上角的 + New 菜单,可以看到你可以提问、运行 SQL 查询以及创建仪表盘:
-
例如,下面这条 SQL 查询在名为
uk_price_paid的表上运行,返回 1995 年至 2022 年各年的平均成交价格:
5. 提出问题
-
点击 + New,然后选择 Question。请注意,你可以从选择数据库和表开始构建问题。例如,下面这个问题针对
default数据库中名为uk_price_paid的表,用于计算 Greater Manchester 郡内各城镇的平均房价: - 点击 Visualize 按钮,以表格视图查看结果。
- 在结果下方,点击 Visualization 按钮,将可视化切换为柱状图 (或其他可用选项) :