跳到主要内容
跳到主要内容

连接 DBeaver 到 ClickHouse

DBeaver 提供多种版本。本指南中使用的是 DBeaver Community 版本。请此处查看各种版本和功能。DBeaver 使用 JDBC 连接到 ClickHouse。

注意

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

1. 收集您的 ClickHouse 详细信息

DBeaver 使用基于 HTTP(S) 的 JDBC 连接到 ClickHouse;您需要

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

2. 下载 DBeaver

DBeaver 可在 https://dbeaver.io/download/ 获取

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 的功能。