跳至主要内容

使用 DBeaver 连接 ClickHouse

DBeaver 提供多种版本。本指南使用 DBeaver 社区版。请参阅 此处了解各种版本和功能。DBeaver 使用 JDBC 通过 HTTP(S) 连接到 ClickHouse。

注意

请使用 DBeaver 23.1.0 或更高版本以获得对 ClickHouse 中 Nullable 列的改进支持。

1. 收集 ClickHouse 信息​

DBeaver 使用 JDBC 通过 HTTP(S) 连接到 ClickHouse；您需要

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

2. 下载 DBeaver​

可以在 https://dbeaver.io/download/ 下载 DBeaver

3. 添加数据库​

  • 使用 **数据库 > 新建数据库连接** 菜单或 **数据库导航器** 中的 **新建数据库连接** 图标打开 **连接到数据库** 对话框

Add a new database

  • 选择 **分析型**，然后选择 **ClickHouse**

  • 构建 JDBC URL。在 **主要** 选项卡上设置主机、端口、用户名、密码和数据库

Set the hostname, port, user, password, and database name

  • 默认情况下，**SSL > 使用 SSL** 属性将未设置，如果您连接到 ClickHouse Cloud 或在 HTTP 端口上需要 SSL 的服务器，则将 **SSL > 使用 SSL** 设置为开启

Enable SSL if required

  • 测试连接

Test the connection

如果 DBeaver 检测到您没有安装 ClickHouse 驱动程序，它将提供为您下载驱动程序

Download the ClickHouse driver

  • 下载驱动程序后，再次 **测试** 连接

Test the connection

4. 查询 ClickHouse​

打开查询编辑器并运行查询。

  • 右键单击您的连接并选择 **SQL 编辑器 > 打开 SQL 脚本** 以打开查询编辑器

Open the SQL editor

  • 针对 system.query_log 的示例查询

    A sample query

后续步骤​

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