将 DBeaver 连接到 ClickHouse

DBeaver 是一款跨平台数据库工具。

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 documentation 了解 ClickHouse 的功能。