Skip to main content

​
描述

只有在配置了 ClickHouse Keeper 或 ZooKeeper 时，该表才存在。system.zookeeper 表会公开配置中定义的 Keeper 集群中的数据。 查询必须在 WHERE 子句中包含 path = 条件，或像下面所示设置 path IN 条件。这对应于你想要获取数据的子节点所在路径。 查询 SELECT * FROM system.zookeeper WHERE path = '/clickhouse' 会输出 /clickhouse 节点下所有子节点的数据。 如需输出所有根节点的数据，请写 path = '/'。 如果 path 中指定的路径不存在，则会抛出异常。 查询 SELECT * FROM system.zookeeper WHERE path IN ('/', '/clickhouse') 会输出 / 和 /clickhouse 节点下所有子节点的数据。 如果指定的 path 集合中包含不存在的路径，则会抛出异常。 它可用于批次查询多个 Keeper 路径。 查询 SELECT * FROM system.zookeeper WHERE path = '/clickhouse' AND zookeeperName = 'auxiliary_cluster' 会输出 auxiliary_cluster ZooKeeper 集群中的数据。 如果指定的 auxiliary_cluster 不存在，则会抛出异常。

​
列

  • name (String) — 节点名称。
  • path (String) — 节点路径。
  • value (String) — 节点值。
  • zookeeperName (String) — 默认 ZooKeeper 集群或某个辅助 ZooKeeper 集群的名称。
  • dataLength (Int32) — 值的大小。
  • numChildren (Int32) — 子孙节点数量。
  • czxid (Int64) — 创建该节点的事务 ID。
  • mzxid (Int64) — 最后一次更改该节点的事务 ID。
  • pzxid (Int64) — 最后一次删除或添加子孙节点的事务 ID。
  • ctime (DateTime) — 节点创建时间。
  • mtime (DateTime) — 节点的最后修改时间。
  • version (Int32) — 节点版本：该节点被更改的次数。
  • cversion (Int32) — 添加或删除子孙节点的次数。
  • aversion (Int32) — ACL 更改次数。
  • ephemeralOwner (Int64) — 对于临时节点，拥有该节点的会话 ID。
示例：
最后修改于 2026年7月3日