连接 ClickHouse 与 Hashboard

由社区维护

Hashboard 是一款交互式数据探索工具，可让组织中的任何人跟踪指标并发现可付诸行动的洞察。Hashboard 会向您的 ClickHouse 数据库发出实时 SQL 查询，尤其适合自助式、临时性的数据探索场景。

本指南将逐步介绍如何将 Hashboard 连接到您的 ClickHouse 实例。相关信息也可参见 Hashboard 的 ClickHouse 集成文档。

先决条件

收集连接详细信息

要通过原生 TCP 连接到 ClickHouse，你需要以下信息：

Parameters	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 管理员设置。

在 Hashboard 中添加新的数据库连接

前往你的 Hashboard 项目。
点击侧边导航栏中的齿轮图标，打开 Settings 页面。
点击 + New Database Connection。
在弹窗中选择“ClickHouse”。
使用之前收集的信息填写 Connection Name、Host、Port、Username、Password 和 Database 字段。
点击“Test”，验证连接是否配置成功。
点击“Add”

现在，你的 ClickHouse 数据库已连接到 Hashboard，接下来可以继续构建数据模型、Explorations、指标和仪表盘。有关这些功能的更多信息，请参阅相应的 Hashboard 文档。

如需了解更多高级功能和故障排查信息，请访问 Hashboard 文档。