ClickHouse连接Navicat失败主因是协议不匹配，需选ClickHouse驱动、用9000端口、核对users.xml认证信息；元数据加载异常属驱动适配问题，应手动刷新；内存超限需在Advanced中设max_memory_usage；中文乱码、时间戳、Decimal精度等问题需调字体、时区及显式类型转换。
ClickHouse 连接失败：Navicat 报 Code: 516. DB::Exception: default: Authentication failed
这是最常见问题，本质是 navicat 默认用 mysql 协议连接，但 clickhouse 的原生协议和认证方式不兼容。必须手动切换驱动类型。
实操建议：
- 新建连接时，类型选
ClickHouse（不是 MySQL 或 PostgreSQL），Navicat 15+ 才内置该选项；旧版本需升级或改用 DBeaver - 主机填真实 IP 或域名，
port默认是9000（HTTP 接口是8123，但 Navicat 必须用原生端口9000） -
username和password要和/etc/clickhouse-server/users.xml中定义的一致；默认用户default可能没设密码，此时密码留空，但需确认allow_empty_password为1 - 如果服务端启用了 TLS，Navicat 不支持原生协议的加密连接，得关掉
tcp_port_secure或换 HTTP 模式（但 Navicat 不支持 HTTP 模式）
Navicat 显示“Database not found”或无法展开库表结构
不是权限问题，而是 Navicat 尝试用 MySQL 的 SHOW DATABASES 类语句查 ClickHouse，而 ClickHouse 不认——它用的是 SELECT name FROM system.databases 这套元数据查询逻辑，Navicat 的 ClickHouse 驱动没完全适配。
实操建议：
- 连接成功后，手动在左侧数据库列表里右键 →
Refresh，别依赖自动加载 - 首次连接时，
Default database字段建议留空，连上后再双击具体库；填了不存在的库名会直接报错退出 - 如果表太多，Navicat 加载
system.tables可能卡顿，可提前在服务端限制：在users.xml的 profile 里加<max_table_size_to_drop>0</max_table_size_to_drop>等无关项没用，真正有效的是<max_rows_to_read>1000000</max_rows_to_read>，但这只影响查询，不影响元数据加载——所以更实际的做法是：删掉不用的库（如system库本身不显示也正常）
执行 INSERT 或复杂 SELECT 报 Code: 241. DB::Exception: Memory limit (for query) exceeded
Navicat 默认不限制查询内存，但 ClickHouse 服务端有 max_memory_usage 硬限制（默认约 10GB），图形客户端容易触发，尤其是预览大表、没加 LIMIT 就点“运行”。
实操建议：
- 在 Navicat 的连接属性 →
Advanced标签页里，填入自定义设置：max_memory_usage=3000000000（3GB），避免超限；注意这里填的是字符串，不是数字，且不能带单位 - 写查询时养成习惯：哪怕只是看数据，也先加
LIMIT 100；Navicat 的“Preview”功能底层就是无 LIMIT 查询，慎用 - 如果执行 INSERT，确保语句里字段顺序、类型和目标表严格一致；ClickHouse 对 CSV/TSV 插入容忍度低，Navicat 的可视化粘贴导入常因空值或类型隐式转换失败
中文乱码、时间显示为 Unix 时间戳、数值精度丢失
Navicat 的 ClickHouse 驱动对数据类型的映射比较原始，比如把 DateTime 当整数读、把 String 当二进制处理、把 Decimal(18,6) 截成 double。
实操建议：
- 连接高级设置里勾选
Use server time zone，并确认服务端timezone配置正确（如Asia/Shanghai）；否则DateTime全显示成秒级时间戳 - 中文字段显示为问号？检查服务端
clickhouse-client能否正常输出中文，若可以，说明是 Navicat 字体或编码问题：菜单 →Tools → Options → Environment → Font换成支持 UTF-8 的字体（如 Microsoft YaHei） -
Decimal类型务必显式转成字符串再查：SELECT toString(price) FROM orders LIMIT 10，否则 Navicat 会按浮点解析，小数位可能四舍五入或丢末尾零
ClickHouse 的协议细节和 Navicat 的适配之间存在几处“灰色地带”，比如 Nullable(String) 字段在 Navicat 里可能显示为 NULL 即使值不为空，这类问题没有通用解法，只能靠具体字段加 toString(coalesce(x, '')) 绕过。
