将 ClickHouse 连接到 Hashboard
Community Maintained
Hashboard 是一个交互式数据探索工具,使您组织中的任何人都可以跟踪指标并发现可操作的见解。Hashboard 向您的 ClickHouse 数据库发出实时 SQL 查询,对于自助服务和临时数据探索用例特别有用。

本指南将引导您完成将 Hashboard 连接到您的 ClickHouse 实例的步骤。这些信息在 Hashboard 的 ClickHouse 集成文档 中也可获取。
先决条件
- 一个 ClickHouse 数据库,托管在您自己的基础设施上或在 ClickHouse Cloud 上。
- 一个 Hashboard 账户 和项目。
将 Hashboard 连接到 ClickHouse 的步骤
1. 收集连接详细信息
要通过原生 TCP 连接到 ClickHouse,您需要以下信息:
-
主机(HOST)和端口(PORT):通常,当使用 TLS 时,端口为 9440,当不使用 TLS 时,端口为 9000。
-
数据库名称(DATABASE NAME):开箱即用有一个名为
default
的数据库,使用您要连接的数据库的名称。 -
用户名(USERNAME)和密码(PASSWORD):开箱即用时,用户名为
default
。使用适合您用例的用户名。
您 ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中找到。选择您要连接的服务,然后单击 Connect:

选择 Native,然后详细信息将在示例 clickhouse-client
命令中提供。

如果您使用的是自管理的 ClickHouse,连接详细信息由您的 ClickHouse 管理员设置。
2. 在 Hashboard 中添加新的数据库连接
- 导航到您的 Hashboard 项目。
- 点击侧边导航栏中的齿轮图标,打开设置页面。
- 点击
+ 新建数据库连接
。 - 在弹出窗口中选择 "ClickHouse"。
- 在字段中填写 连接名称、主机、端口、用户名、密码 和 数据库 的信息。
- 点击 "测试" 以验证连接是否配置成功。
- 点击 "添加"
您的 ClickHouse 数据库现在已连接到 Hashboard,您可以继续构建 数据模型、探索、指标 和 仪表板。有关这些功能的更多详细信息,请参见相应的 Hashboard 文档。
了解更多
有关更高级功能和故障排除,请访问 Hashboard 的文档。