跳转到主内容
跳转到主内容

连接 ClickHouse 与 Hashboard

Community Maintained

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

显示交互式查询构建器和可视化功能的 Hashboard 数据探索界面

本指南将逐步介绍如何将 Hashboard 连接到您的 ClickHouse 实例。相关信息也可参阅 Hashboard 的 ClickHouse integration documentation。

前提条件​

将 Hashboard 连接到 ClickHouse 的操作步骤​

1. 准备您的连接信息​

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

ParametersDescription
HOST and PORT通常在使用 TLS 时端口为 9440，不使用 TLS 时端口为 9000。
DATABASE NAME默认提供名为 default 的数据库，请使用您要连接的数据库名称。
USERNAME and PASSWORD默认用户名为 default。请根据您的使用场景选择合适的用户名。

ClickHouse Cloud 服务的详细信息可以在 ClickHouse Cloud 控制台中查看。 选择要连接的服务并点击 Connect：

ClickHouse Cloud service connect button

选择 Native，示例 clickhouse-client 命令中会展示连接所需的详细信息。

ClickHouse Cloud Native TCP connection details

如果您使用的是自管的 ClickHouse，连接信息由 ClickHouse 管理员进行配置。

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

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

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

了解更多​

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