Skip to main content
DBeaver 提供多个版本。本指南使用的是 DBeaver Community。请在此处查看不同版本及其能力。DBeaver 使用 JDBC 连接到 ClickHouse。
为了更好地支持 ClickHouse 中的 Nullable 列,请使用 DBeaver 23.1.0 或更高版本。
1

收集你的 ClickHouse 详细信息

DBeaver 使用基于 HTTP(S) 的 JDBC 连接到 ClickHouse;你需要:
  • 端点
  • 端口号
  • 用户名
  • 密码
2

下载 DBeaver

DBeaver 可从 https://dbeaver.io/download/ 下载
3

添加数据库

  • 通过 Database > New Database Connection 菜单,或点击 Database Navigator 中的 New Database Connection 图标,打开 Connect to a database 对话框:
  • 选择 Analytical,然后选择 ClickHouse
  • 构建 JDBC URL。在 Main 选项卡中设置 Host、Port、Username、Password 和 Database:
  • 默认情况下,SSL > Use SSL 属性未启用;如果要连接到 ClickHouse Cloud 或在 HTTP 端口上要求使用 SSL 的 server,请启用 SSL > Use SSL
  • 测试连接:
如果 DBeaver 检测到尚未安装 ClickHouse driver,它会提示你下载:
  • 下载 driver 后,再次 Test 连接:
4

查询 ClickHouse

打开查询编辑器并运行查询。
  • 右键点击你的连接,选择 SQL Editor > Open SQL Script 以打开查询编辑器:
  • 针对 system.query_log 的示例查询:

后续步骤

请参阅 DBeaver wiki 了解 DBeaver 的功能,并参阅 ClickHouse 文档 了解 ClickHouse 的功能。
最后修改于 2026年7月24日