首页/数据/NoSQL 速查/ZooKeeper 协调配置
ClickHouse56 条

ZooKeeper 协调配置

副本表与分布式 DDL 依赖 ZooKeeper(或 Keeper):在 config.xml 的 zookeeper 段配置节点列表,并设置 session 超时;同一集群的所有节点应指向同一组协调服务。

NoSQL 速查数据更新于 2026-10-12
配置位置/etc/clickhouse-server/config.xml 的 <zookeeper> 段
节点格式<node><host>…</host><port>2181</port></node>,可配多个
相关参数session_timeout_ms、operation_timeout_ms、root 路径

示例

示例
<zookeeper>
  <node>
    <host>zk-1</host>
    <port>2181</port>
  </node>
  <node>
    <host>zk-2</host>
    <port>2181</port>
  </node>
  <session_timeout_ms>30000</session_timeout_ms>
  <operation_timeout_ms>10000</operation_timeout_ms>
</zookeeper>
ZooKeeper 不可用期间已有副本表通常仍可读,但不能创建新副本、也不能做副本注册类操作。

易错点

  • 三个 ZooKeeper 节点只部署在一台机器上的伪高可用没有意义,故障域要分开
  • 协调节点用满磁盘后副本会集体只读,监控要覆盖 ZK 磁盘与延迟

数据来源与参考

  • ClickHouse Docs: ZooKeeper
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌