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

> ClickHouse Keeper 또는 ZooKeeper가 구성된 경우에만 존재하는 시스템 테이블입니다. 구성에 정의된 Keeper 클러스터의 데이터를 제공합니다.

# system.zookeeper

## 설명

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`가 존재하지 않으면 예외가 발생합니다.

## Columns

* `name` ([String](/ko/reference/data-types/string)) — 노드의 이름입니다.
* `value` ([String](/ko/reference/data-types/string)) — 노드 값입니다.
* `zookeeperName` ([String](/ko/reference/data-types/string)) — 기본 ZooKeeper 클러스터 또는 보조 ZooKeeper 클러스터 중 하나의 이름입니다.
* `czxid` ([Int64](/ko/reference/data-types/int-uint)) — 노드를 생성한 트랜잭션의 ID입니다.
* `mzxid` ([Int64](/ko/reference/data-types/int-uint)) — 노드를 마지막으로 변경한 트랜잭션의 ID입니다.
* `ctime` ([DateTime](/ko/reference/data-types/datetime)) — 노드 생성 시각입니다.
* `mtime` ([DateTime](/ko/reference/data-types/datetime)) — 노드가 마지막으로 수정된 시각입니다.
* `version` ([Int32](/ko/reference/data-types/int-uint)) — 노드 버전, 즉 노드가 변경된 횟수입니다.
* `cversion` ([Int32](/ko/reference/data-types/int-uint)) — 추가되거나 제거된 하위 노드의 수입니다.
* `aversion` ([Int32](/ko/reference/data-types/int-uint)) — ACL 변경 횟수입니다.
* `ephemeralOwner` ([Int64](/ko/reference/data-types/int-uint)) — 임시(ephemeral) 노드일 때 이 노드를 소유한 세션의 ID입니다.
* `dataLength` ([Int32](/ko/reference/data-types/int-uint)) — 값의 크기입니다.
* `numChildren` ([Int32](/ko/reference/data-types/int-uint)) — 하위 노드의 수입니다.
* `pzxid` ([Int64](/ko/reference/data-types/int-uint)) — 하위 노드를 마지막으로 삭제하거나 추가한 트랜잭션의 ID입니다.
* `path` ([String](/ko/reference/data-types/string)) — 노드의 경로입니다.

## 예시

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