> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 仅在配置了 ClickHouse Keeper 或 ZooKeeper 时才存在的系统表。它会公开配置中定义的 Keeper 集群中的数据。

# system.zookeeper

<div id="description">
  ## 描述
</div>

只有在配置了 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` 不存在，则会抛出异常。

<div id="columns">
  ## 列
</div>

* `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。

示例：

```sql theme={null}
SELECT *
FROM system.zookeeper
WHERE path = '/clickhouse/tables/01-08/visits/replicas'
FORMAT Vertical
```

```text theme={null}
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
```