> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.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` 테이블은 config에 정의된 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` collection에 존재하지 않는 경로가 있으면 예외가 발생합니다.
Keeper 경로 쿼리를 batch로 수행할 때 사용할 수 있습니다.

쿼리 `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) — 노드를 생성한 transaction의 ID입니다.
* `mzxid` (Int64) — 노드를 마지막으로 변경한 transaction의 ID입니다.
* `pzxid` (Int64) — 하위 노드를 마지막으로 삭제하거나 추가한 transaction의 ID입니다.
* `ctime` (DateTime) — 노드가 생성된 시간입니다.
* `mtime` (DateTime) — 노드가 마지막으로 수정된 시간입니다.
* `version` (Int32) — 노드 버전으로, 노드가 변경된 횟수입니다.
* `cversion` (Int32) — 하위 노드가 추가되거나 제거된 횟수입니다.
* `aversion` (Int32) — ACL이 변경된 횟수입니다.
* `ephemeralOwner` (Int64) — ephemeral 노드인 경우, 이 노드를 소유한 session의 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
```