> ## 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 server 当前已注册的活跃 ZooKeeper watch 的系统表。

# system.zookeeper_watches

## 描述

显示此 ClickHouse server 当前在 ZooKeeper 节点 (包括辅助 ZooKeeper) 上注册的活动 [watch](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html#ch_zkWatches)。每一行表示一个 watch。

**可用性**

`system.zookeeper_watches` 仅在配置了 ClickHouse Keeper 或 ZooKeeper 时存在。在两者均未配置的服务器上，该表不存在，对其执行的查询会以 `UNKNOWN_TABLE` 错误失败。

## 列

* `zookeeper_name` ([String](/zh/reference/data-types/string)) — ZooKeeper 连接的名称 (主连接为 "default"，或辅助连接名称) 。
* `create_time` ([DateTime](/zh/reference/data-types/datetime)) — watch 创建的时间。
* `create_time_microseconds` ([DateTime64(6)](/zh/reference/data-types/datetime64)) — 以微秒精度记录的 watch 创建时间。
* `path` ([String](/zh/reference/data-types/string)) — 被 watch 监听的 ZooKeeper 路径。
* `session_id` ([Int64](/zh/reference/data-types/int-uint)) — 注册该 watch 的连接的会话 ID。
* `request_xid` ([Int64](/zh/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)](/zh/reference/data-types/enum)) — 创建该 watch 的操作。
* `watch_type` ([Enum8('Unexpected' = -1, 'Children' = 1, 'Exists' = 2, 'Data' = 3)](/zh/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](/zh/guides/oss/best-practices/tips#zookeeper)
* [ZooKeeper 指南](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html)