将 ClickHouse 连接到 Hashboard
Hashboard 是一款交互式数据探索工具,使您组织中的任何人都能跟踪指标并发现可操作的洞察。 Hashboard 向您的 ClickHouse 数据库发出实时 SQL 查询,特别适用于自助式、临时的数据探索用例。

本指南将指导您完成将 Hashboard 连接到您的 ClickHouse 实例的步骤。此信息也可以在 Hashboard 的 ClickHouse 集成文档 中找到。
先决条件
- 一个 ClickHouse 数据库,可以在您自己的基础设施上托管,也可以在 ClickHouse Cloud 上托管。
- 一个 Hashboard 账户 和项目。
将 Hashboard 连接到 ClickHouse 的步骤
1. 收集您的连接详细信息
ClickHouse にネイティブ TCP で接続するには、次の情報が必要です:
-
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 的文档。