> ## 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.
# 连接 Chartbrew 与 ClickHouse
> 连接 Chartbrew 与 ClickHouse，创建实时仪表盘和客户报告。
export const Image = ({img, alt, size}) => {
return
;
};
export const CommunityMaintainedBadge = () => {
return ;
};
[Chartbrew](https://chartbrew.com) 是一个数据可视化平台，可让您创建仪表盘并实时监控数据。它支持包括 ClickHouse 在内的多种数据源，并提供用于构建图表和报表的无代码界面。
## 目标
在本指南中，你将把 Chartbrew 连接到 ClickHouse，运行 SQL 查询并创建可视化图表。完成后，你的仪表盘大致会如下所示：
**添加一些数据**
如果你还没有可用的数据集，可以添加一个示例数据集。本指南使用 [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. 将 Chartbrew 连接到 ClickHouse
1. 登录 [Chartbrew](https://chartbrew.com/login)，然后转到 **Connections** 选项卡。
2. 点击 **Create connection**，然后在可用的数据库选项中选择 **ClickHouse**。
3. 输入 ClickHouse 数据库的连接详细信息：
* **Display Name**：用于在 Chartbrew 中标识该连接的名称。
* **Host**：ClickHouse server 的主机名或 IP 地址。
* **Port**：HTTPS 连接通常使用 `8443`。
* **Database Name**：要连接的数据库。
* **Username**：你的 ClickHouse 用户名。
* **Password**：你的 ClickHouse 密码。
4. 点击 **Test connection**，验证 Chartbrew 是否能够连接到 ClickHouse。
5. 如果测试成功，点击 **Save connection**。Chartbrew 会自动从 ClickHouse 检索 schema。
## 3. 创建数据集并运行 SQL 查询
1. 点击 **Create dataset** 按钮，或前往 **Datasets** 选项卡创建数据集。
2. 选择你之前创建的 ClickHouse 连接。
编写一条 SQL 查询，以获取要可视化的数据。例如，以下查询会计算 `uk_price_paid` 数据集中每年已支付价格的平均值：
```sql theme={null}
SELECT toYear(date) AS year, avg(price) AS avg_price
FROM uk_price_paid
GROUP BY year
ORDER BY year;
```
点击 **Run query** 获取数据。
如果你不确定如何编写查询，可以使用 **Chartbrew 的 AI 助手** 根据你的数据库 schema 生成 SQL 查询。
获取到数据后，点击 **Configure dataset** 配置可视化参数。
## 4. 创建可视化
1. 为可视化定义指标 (数值) 和维度 (分类值) 。
2. 预览数据集，确保查询结果结构正确。
3. 选择一种图表类型 (如折线图、柱状图、饼图) ，并将其添加到仪表盘。
4. 点击 **Complete dataset** 完成设置。
你可以根据需要创建任意数量的数据集，以可视化数据的不同方面。借助这些数据集，你可以创建多个仪表盘来跟踪不同的指标。
## 5. 自动更新数据
要让您的仪表盘保持最新状态，您可以设置自动更新数据：
1. 点击数据集刷新按钮旁边的日历图标。
2. 配置更新时间间隔 (例如每小时一次、每天一次) 。
3. 保存设置以启用自动刷新。
## 了解更多
如需了解更多详情，请参阅这篇关于 [Chartbrew 和 ClickHouse](https://chartbrew.com/blog/visualizing-clickhouse-data-with-chartbrew-a-step-by-step-guide/) 的博文。