> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-1d264819.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Metabase 是一款易于使用的开源 UI 工具，可用于查询您的数据。
# 将 Metabase 连接到 ClickHouse
export const PartnerBadge = () => {
return ;
};
export const Image = ({img, alt, size}) => {
return
;
};
Metabase 是一款易于使用的开源 UI 工具，可用于查询和分析您的数据。Metabase 是一个 Java 应用程序，只需下载 JAR 文件并使用 `java -jar metabase.jar` 运行即可。Metabase 通过您下载并放入 `plugins` 文件夹中的 JDBC 驱动连接到 ClickHouse：
## 目标
在本指南中，你将使用 Metabase 向 ClickHouse 中的数据提出一些问题，并将答案可视化。其中一个结果会类似这样：
**添加一些数据**
如果你还没有可用的数据集，可以添加一个示例数据集。本指南使用 [UK Price Paid](/zh/get-started/sample-datasets/uk-price-paid) 数据集，因此你也可以选择它。同一文档分类下还有其他几个示例可供参考。
## 1. 收集您的连接信息
要通过 HTTP(S) 连接到 ClickHouse，你需要以下信息：
| Parameter(s) | Description |
| ------------------------- | ------------------------------------------ |
| `HOST` and `PORT` | 通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。 |
| `DATABASE NAME` | 默认情况下，存在一个名为 `default` 的数据库。请使用你要连接的数据库名称。 |
| `USERNAME` and `PASSWORD` | 默认情况下，用户名为 `default`。请根据你的使用场景使用相应的用户名。 |
你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。
选择一个服务，然后点击 **Connect**：
选择 **HTTPS**。连接信息会显示在示例 `curl` 命令中。
如果你使用的是自管理 ClickHouse，则连接信息由你的 ClickHouse 管理员配置。
## 2. 下载 Metabase 的 ClickHouse 插件
1. 如果你还没有 `plugins` 文件夹，请在保存 `metabase.jar` 的目录下创建一个 `plugins` 子文件夹。
2. 该插件是一个名为 `clickhouse.metabase-driver.jar` 的 JAR 文件。请在 [https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest](https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest) 下载该 JAR 文件的最新版本。
3. 将 `clickhouse.metabase-driver.jar` 保存到 `plugins` 文件夹中。
4. 启动 (或重启) Metabase，以确保驱动程序正确加载。
5. 通过 [http://hostname:3000](http://hostname:3000) 访问 Metabase。首次启动时，你会看到欢迎界面，并需要依次回答一系列问题。如果系统提示你选择数据库，请选择“**稍后再添加我的数据**”：
## 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. 例如，下面这条 SQL 查询在名为 `uk_price_paid` 的表上运行，返回 1995 年至 2022 年各年的平均成交价格：
## 5. 提出问题
1. 点击 **+ New**，然后选择 **Question**。请注意，你可以从选择数据库和表开始构建问题。例如，下面这个问题针对 `default` 数据库中名为 `uk_price_paid` 的表，用于计算 Greater Manchester 郡内各城镇的平均房价：
2. 点击 **Visualize** 按钮，以表格视图查看结果。
3. 在结果下方，点击 **Visualization** 按钮，将可视化切换为柱状图 (或其他可用选项) ：
## 了解更多
若要进一步了解 Metabase 以及如何构建仪表盘，请访问 Metabase 文档。