告别命令行！用DBeaver连接ClickHouse保姆级教程（附8123端口排查指南）

从零开始：DBeaver图形化操作ClickHouse全流程指南

第一次打开DBeaver准备连接ClickHouse时，我盯着那个8123端口的报错信息足足发了十分钟呆。作为从MySQL转型过来的数据分析师，本以为换个数据库不过是换个连接地址的事，没想到连最简单的连接环节就给我来了个下马威。这就是为什么我决定写下这篇指南——不仅告诉你正确路径，还要带你绕过所有我踩过的坑。

1. 环境准备与基础配置

1.1 软件安装与初始化

DBeaver的社区版就足够应对大多数ClickHouse操作场景，但有两个细节需要注意：

• 版本匹配：21.7之后的ClickHouse对协议有更新，建议使用DBeaver 7.3.5及以上版本
• 驱动管理：首次连接时会提示下载JDBC驱动，建议选择最新稳定版而非默认版本

安装完成后别急着连接，先做这两个关键设置：

# 在DBeaver首选项中找到"连接"设置
1. 勾选"自动提交模式"（避免忘记提交事务）
2. 设置"连接超时"为60秒（ClickHouse复杂查询可能需要更长时间）

1.2 ClickHouse服务端检查

在服务器终端运行以下命令确认服务状态：

# 检查服务状态
systemctl status clickhouse-server

# 查看监听端口（应有8123和9000）
netstat -tulnp | grep clickhouse

如果发现8123端口未监听，90%的情况是这两个问题：

1. 配置文件未开放远程连接：检查/etc/clickhouse-server/config.xml中的：