将 ClickHouse 连接到 Hashboard
Community Maintained
Hashboard 是一款交互式数据探索工具，可让你组织中的任何人跟踪各类指标并发现可操作的洞察。Hashboard 会向你的 ClickHouse 数据库发出实时 SQL 查询，特别适用于自助式、临时性的数据探索场景。
本指南将引导你完成将 Hashboard 与 ClickHouse 实例连接的步骤。你也可以在 Hashboard 的 ClickHouse 集成文档 中找到相同信息。
前提条件
- 一个 ClickHouse 数据库，可以部署在你自己的基础设施上，或托管在 ClickHouse Cloud 上。
- 一个 Hashboard 账户 以及一个项目。
将 Hashboard 连接到 ClickHouse 的步骤
1. 收集连接信息
要通过原生 TCP 协议连接到 ClickHouse，需要以下信息：
| Parameter(s) | Description |
|---|---|
HOST and PORT | 通常在使用 TLS 时端口为 9440，不使用 TLS 时端口为 9000。 |
DATABASE NAME | 默认提供名为 default 的数据库，请使用您要连接的数据库名称。 |
USERNAME and PASSWORD | 默认用户名为 default。请根据您的使用场景选择合适的用户名。 |
ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择要连接的服务并点击 Connect：
选择 Native，示例 clickhouse-client 命令中会展示连接所需的详细信息。
如果您使用的是自管的 ClickHouse，连接信息由 ClickHouse 管理员进行配置。
2. 在 Hashboard 中添加新的数据库连接
- 进入你的 Hashboard 项目。
- 点击侧边导航栏中的齿轮图标，打开 Settings 页面。
- 点击
+ New Database Connection。 - 在弹出窗口中选择 "ClickHouse"。
- 使用之前收集的信息填写 Connection Name、Host、Port、Username、Password 和 Database 字段。
- 点击 "Test" 以验证连接是否已成功配置。
- 点击 "Add"。
你的 ClickHouse 数据库现在已经连接到 Hashboard。接下来，你可以开始构建 Data Models、Explorations、Metrics 和 Dashboards。有关这些功能的更多详细信息，请参阅对应的 Hashboard 文档。
了解更多
如需了解更多高级功能和故障排除方法，请访问 Hashboard 文档。
