clickhouse-server

ClickHouse 服务端启动与配置

补充说明

clickhouse-server 启动 ClickHouse 服务，读取主配置和 config.d/、users.d/ 覆盖文件。它负责查询执行、存储和副本协调。

常用示例

clickhouse-server --config-file=/etc/clickhouse-server/config.xml
clickhouse-server --config-file=/etc/clickhouse-server/config.xml --daemon
clickhouse-server --pid-file=/run/clickhouse-server/clickhouse-server.pid
clickhouse-server --version
systemctl status clickhouse-server
clickhouse-client -q 'SELECT version(), uptime()'

配置覆盖：

# /etc/clickhouse-server/config.d/listen.xml
<clickhouse>
  <listen_host>0.0.0.0</listen_host>
</clickhouse>

易错点与排错

• 主配置和 config.d/ 的合并顺序要确认；同名项可能被覆盖。
• users.xml 控制用户、密码和配额；改完要确认用户仍能登录。
• 默认只监听本地或特定地址；远程访问要配置 listen_host 和防火墙。
• 数据目录、日志目录和临时目录权限要属于 clickhouse 用户。
• 内存限制和 max_memory_usage 要匹配机器/容器 limit，否则查询会被杀。
• 复制表依赖 Keeper/ZooKeeper；没有协调服务时副本无法工作。
• 文件描述符和进程数限制要调大；高并发下容易触顶。
• 升级前看兼容性说明，尤其是表引擎和配置格式变化。

相关命令

• clickhouse-client — 客户端
• clickhouse-local — 本地查询
• clickhouse-backup — 备份恢复