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

使用 DBeaver 连接 ClickHouse

Partner Integration

DBeaver 有多个版本可供选择。本指南使用的是 DBeaver Community。请在此处查看不同版本及其功能。DBeaver 使用 JDBC 连接到 ClickHouse。

注意

为更好地支持 ClickHouse 中的 Nullable 列，请使用 DBeaver 23.1.0 或更高版本。

1. 收集您的 ClickHouse 连接信息​

DBeaver 通过基于 HTTP(S) 的 JDBC 连接到 ClickHouse；您需要：

  • endpoint
  • 端口号
  • 用户名
  • 密码

2. 下载 DBeaver​

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

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 的服务器，则需要启用 SSL > Use SSL：
如有需要则启用 SSL
  • 测试连接：
测试连接

如果 DBeaver 检测到尚未安装 ClickHouse 驱动，它会提示下载驱动：

下载 ClickHouse 驱动
  • 下载驱动后再次 Test 连接：
测试连接

4. 在 ClickHouse 中执行查询​

打开查询编辑器并运行一条查询语句。

  • 右键单击你的连接并选择 SQL Editor > Open SQL Script 以打开查询编辑器：
打开 SQL 编辑器
  • 针对 system.query_log 的示例查询：
示例查询

后续步骤​

请参阅 DBeaver wiki 了解 DBeaver 的功能，并参阅 ClickHouse 文档 了解 ClickHouse 的功能。