2022-08-28 13:53:52 +00:00
---
2022-08-28 13:58:27 +00:00
slug: /en/operations/system-tables/zookeeper
2022-08-28 13:53:52 +00:00
---
2022-06-02 10:55:18 +00:00
# zookeeper
2020-06-18 08:24:31 +00:00
2022-05-20 21:43:23 +00:00
The table does not exist unless ClickHouse Keeper or ZooKeeper is configured. The `system.zookeeper` table exposes data from the Keeper cluster defined in the config.
2022-05-20 21:34:14 +00:00
The query must either have a ‘ path =’ condition or a `path IN` condition set with the `WHERE` clause as shown below. This corresponds to the path of the children that you want to get data for.
2020-06-18 08:24:31 +00:00
The query `SELECT * FROM system.zookeeper WHERE path = '/clickhouse'` outputs data for all children on the `/clickhouse` node.
To output data for all root nodes, write path = ‘ /’ .
2021-05-27 19:44:11 +00:00
If the path specified in ‘ path’ does not exist, an exception will be thrown.
2020-06-18 08:24:31 +00:00
2021-02-05 09:46:08 +00:00
The query `SELECT * FROM system.zookeeper WHERE path IN ('/', '/clickhouse')` outputs data for all children on the `/` and `/clickhouse` node.
2021-05-27 19:44:11 +00:00
If in the specified ‘ path’ collection has does not exist path, an exception will be thrown.
2022-05-20 21:34:14 +00:00
It can be used to do a batch of Keeper path queries.
2021-02-05 09:46:08 +00:00
2020-06-18 08:24:31 +00:00
Columns:
2023-04-19 15:55:29 +00:00
- `name` (String) — The name of the node.
- `path` (String) — The path to the node.
- `value` (String) — Node value.
- `dataLength` (Int32) — Size of the value.
- `numChildren` (Int32) — Number of descendants.
- `czxid` (Int64) — ID of the transaction that created the node.
- `mzxid` (Int64) — ID of the transaction that last changed the node.
- `pzxid` (Int64) — ID of the transaction that last deleted or added descendants.
- `ctime` (DateTime) — Time of node creation.
- `mtime` (DateTime) — Time of the last modification of the node.
- `version` (Int32) — Node version: the number of times the node was changed.
- `cversion` (Int32) — Number of added or removed descendants.
- `aversion` (Int32) — Number of changes to the ACL.
- `ephemeralOwner` (Int64) — For ephemeral nodes, the ID of the session that owns this node.
2020-06-18 08:24:31 +00:00
Example:
``` sql
SELECT *
FROM system.zookeeper
WHERE path = '/clickhouse/tables/01-08/visits/replicas'
FORMAT Vertical
```
``` text
Row 1:
──────
2022-03-12 06:24:31 +00:00
name: example01-08-1
2020-06-18 08:24:31 +00:00
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:
──────
2022-03-12 06:24:31 +00:00
name: example01-08-2
2020-06-18 08:24:31 +00:00
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
```