首页/数据/NoSQL 速查/ClickHouse Keeper 内置协调服务
ClickHouse56 条

ClickHouse Keeper 内置协调服务

Keeper 是 ClickHouse 自带的协调实现,可在 config.xml 用 keeper_server 段开启并配置 raft 集群,逐步替代外部 ZooKeeper;配置完成后客户端侧写法与 ZooKeeper 一致。

NoSQL 速查数据更新于 2026-10-12
配置段keeper_server:tcp_port、server_id、log/snapshot 路径、raft_configuration
连接方式zookeeper 段指向 Keeper 端口(如 9181)即可
运维配合 4lw 命令(如 mntr)或 system.zookeeper 表查看状态

示例

示例
<keeper_server>
  <tcp_port>9181</tcp_port>
  <server_id>1</server_id>
  <log_storage_path>/var/lib/clickhouse/coordination/log</log_storage_path>
  <snapshot_storage_path>/var/lib/clickhouse/coordination/snapshots</snapshot_storage_path>
  <raft_configuration>
    <server>
      <id>1</id>
      <hostname>ch-1</hostname>
      <port>9234</port>
    </server>
  </raft_configuration>
</keeper_server>
迁移期 ZooKeeper 与 Keeper 可以并存指向同一数据(Keeper 兼容 ZK 协议),切换时先小范围验证。

易错点

  • server_id 与 raft server id 都要唯一,复制配置到多机时最容易漏改
  • 切换协调服务前先确认副本表路径未变,路径规则不一致会导致新副本从头同步

数据来源与参考

  • ClickHouse Docs: ClickHouse Keeper
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌