> ## 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 서버에 등록된 현재 활성 상태의 ZooKeeper watch를 보여주는 시스템 테이블입니다.

# system.zookeeper_watches

## 설명

이 ClickHouse 서버가 ZooKeeper 노드(보조 ZooKeeper 인스턴스 포함)에 등록한 현재 활성 [watch](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html#ch_zkWatches)를 표시합니다. 각 행은 watch 1개를 나타냅니다.

**가용성**

`system.zookeeper_watches`는 ClickHouse Keeper 또는 ZooKeeper가 구성되어 있을 때만 존재합니다. 둘 중 어느 것도 구성되지 않은 서버에서는 이 테이블이 존재하지 않으며, 해당 테이블에 대한 쿼리는 `UNKNOWN_TABLE` 오류로 실패합니다.

## 컬럼

* `zookeeper_name` ([String](/ko/reference/data-types/string)) — ZooKeeper 연결 이름입니다(기본 연결은 "default", 보조 연결은 해당 이름 사용).
* `create_time` ([DateTime](/ko/reference/data-types/datetime)) — watch가 생성된 시간입니다.
* `create_time_microseconds` ([DateTime64(6)](/ko/reference/data-types/datetime64)) — watch가 마이크로초 정밀도로 생성된 시간입니다.
* `path` ([String](/ko/reference/data-types/string)) — watch가 설정된 ZooKeeper 경로입니다.
* `session_id` ([Int64](/ko/reference/data-types/int-uint)) — watch를 등록한 연결의 세션 ID입니다.
* `request_xid` ([Int64](/ko/reference/data-types/int-uint)) — watch를 생성한 요청의 XID입니다.
* `op_num` ([Enum16('Close' = -11, 'Error' = -1, 'Watch' = 0, 'Create' = 1, 'Remove' = 2, 'Exists' = 3, 'Get' = 4, 'Set' = 5, 'GetACL' = 6, 'SetACL' = 7, 'SimpleList' = 8, 'Sync' = 9, 'Heartbeat' = 11, 'List' = 12, 'Check' = 13, 'Multi' = 14, 'Create2' = 15, 'Reconfig' = 16, 'CheckWatch' = 17, 'RemoveWatch' = 18, 'CreateContainer' = 19, 'CreateTTL' = 21, 'MultiRead' = 22, 'Auth' = 100, 'SetWatch' = 101, 'SetWatch2' = 105, 'AddWatch' = 106, 'FilteredList' = 500, 'CheckNotExists' = 501, 'CreateIfNotExists' = 502, 'RemoveRecursive' = 503, 'CheckStat' = 504, 'TryRemove' = 505, 'FilteredListWithStatsAndData' = 506, 'ListRecursive' = 507, 'SessionID' = 997)](/ko/reference/data-types/enum)) — watch를 생성한 작업입니다.
* `watch_type` ([Enum8('Unexpected' = -1, 'Children' = 1, 'Exists' = 2, 'Data' = 3)](/ko/reference/data-types/enum)) — watch 유형입니다: Children(list), Exists 또는 Data(get).

## 예시

```sql theme={null}
SELECT * FROM system.zookeeper_watches FORMAT Vertical;
```

```text theme={null}
Row 1:
──────
zookeeper_name:           default
create_time:              2026-03-16 12:00:00
create_time_microseconds: 2026-03-16 12:00:00.123456
path:                     /clickhouse/task_queue/ddl
session_id:               106662742089334927
request_xid:              10858
op_num:                   List
watch_type:               Children
```

## 관련 항목

* [ZooKeeper](/ko/guides/oss/best-practices/tips#zookeeper)
* [ZooKeeper 안내서](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html)