clickhouse-keeper

ClickHouse Keeper 协调服务

补充说明

ClickHouse Keeper 是 ZooKeeper 的替代实现，用于 ClickHouse 副本协调。它内置于 ClickHouse，也可以用独立进程运行。

常用示例

clickhouse-keeper --config-file=/etc/clickhouse-keeper/keeper_config.xml
clickhouse-keeper-client -h 127.0.0.1 -p 9181

配置要点：

<keeper_server>
  <tcp_port>9181</tcp_port>
  <server_id>1</server_id>
  <raft_configuration>
    <server>
      <id>1</id>
      <hostname>ch1</hostname>
      <port>9234</port>
    </server>
  </raft_configuration>
</keeper_server>

客户端：

ls /
get /clickhouse/tables/...
stat /clickhouse

易错点与排错

• 集群需要奇数节点（3/5）保持 quorum；server_id 必须唯一。
• Raft 端口（默认 9234）和客户端端口（9181）不同，防火墙都要放行。
• 从 ZooKeeper 迁移要按官方步骤，先验证元数据兼容。
• 快照/日志目录要持久化并监控磁盘。
• 时钟偏差和网络分区会影响选举；保持 NTP。
• 副本表依赖 Keeper；Keeper 不可用时副本无法协调。
• 升级要逐个节点进行，观察 leader 和 quorum。

相关命令

• clickhouse-keeper — 服务端
• clickhouse-keeper-client — 客户端
• clickhouse-server — ClickHouse