跳到主要内容
跳到主要内容

system.zookeeper

除非配置了 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。

示例:

SELECT *
FROM system.zookeeper
WHERE path = '/clickhouse/tables/01-08/visits/replicas'
FORMAT Vertical
Row 1:
──────
name:           example01-08-1
value:
czxid:          932998691229
mzxid:          932998691229
ctime:          2015-03-27 16:49:51
mtime:          2015-03-27 16:49:51
version:        0
cversion:       47
aversion:       0
ephemeralOwner: 0
dataLength:     0
numChildren:    7
pzxid:          987021031383
path:           /clickhouse/tables/01-08/visits/replicas

Row 2:
──────
name:           example01-08-2
value:
czxid:          933002738135
mzxid:          933002738135
ctime:          2015-03-27 16:57:01
mtime:          2015-03-27 16:57:01
version:        0
cversion:       37
aversion:       0
ephemeralOwner: 0
dataLength:     0
numChildren:    7
pzxid:          987021252247
path:           /clickhouse/tables/01-08/visits/replicas