Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

将 DBeaver 连接到 ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP
合作伙伴集成

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

收集你的 ClickHouse 详细信息

DBeaver 使用基于 HTTP(S) 的 JDBC 连接到 ClickHouse；你需要：

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

下载 DBeaver

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

添加数据库

  • 通过 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：
根据需要启用 SSL
  • 测试连接：
测试连接

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

下载 ClickHouse driver
  • 下载 driver 后，再次 Test 连接：
测试连接

查询 ClickHouse

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

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

后续步骤

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

Navigation