无法将ClickHouse Server连接到DBeaver,请求技术解决方案
解决ClickHouse与DBeaver连接问题的步骤
核对基础连接参数
确认DBeaver内的配置项:- 主机:填写ClickHouse服务器的正确IP/域名,远程连接不要用
localhost - 端口:默认HTTP协议端口为
8123,原生TCP端口为9000,需与服务器配置对应 - 数据库:填
default或目标数据库名 - 账号:默认用户为
default,若服务器设置了密码需同步填写
- 主机:填写ClickHouse服务器的正确IP/域名,远程连接不要用
确认驱动加载正确
- 打开DBeaver的驱动管理器,找到ClickHouse驱动
- 替换DBeaver自带的旧驱动文件为你下载的最新版本
- 确保驱动类选择正确:新版JDBC驱动类为
com.clickhouse.jdbc.ClickHouseDriver,旧版为ru.yandex.clickhouse.ClickHouseDriver
检查服务器网络与配置
- 验证服务器防火墙是否开放了对应端口,可通过
telnet 服务器IP 8123测试连通性 - 修改ClickHouse的
config.xml配置,将listen_host设为0.0.0.0(允许所有IP访问),修改后重启ClickHouse服务 - 确认服务器状态正常,可通过
clickhouse-client本地连接测试
- 验证服务器防火墙是否开放了对应端口,可通过
调整连接高级参数
在DBeaver连接设置的「高级」标签中添加以下参数:ssl=false(未开启HTTPS时启用)use_server_time_zone=truesocket_timeout=30000
同时确保JDBC URL格式为jdbc:clickhouse://host:port/db,避免多余参数
排查驱动兼容性
若最新驱动仍无法连接,可尝试降级至前几个稳定版本的JDBC驱动,部分DBeaver版本可能与最新驱动存在兼容问题
内容的提问来源于stack exchange,提问作者rem
相关产品推荐
相关产品推荐

