system.zookeeper_watches

显示此 ClickHouse server 当前已注册的活跃 ZooKeeper watch 的系统表。

​

描述

显示此 ClickHouse server 当前在 ZooKeeper 节点 (包括辅助 ZooKeeper) 上注册的活动 watch。每一行表示一个 watch。

​

列

• zookeeper_name (String) — ZooKeeper 连接的名称 (主连接为 default，或辅助连接名称) 。
• create_time (DateTime) — watch 创建的时间。
• create_time_microseconds (DateTime64) — 以微秒精度记录的 watch 创建时间。
• path (String) — 被 watch 监听的 ZooKeeper 路径。
• session_id (Int64) — 注册该 watch 的连接的会话 ID。
• request_xid (Int64) — 创建该 watch 的请求的 XID。
• op_num (Enum) — 创建该 watch 的请求类型。
• watch_type (Enum8) — watch 类型。可能的值：
  • Children — 监听子节点列表的变化 (由 List 操作设置) 。
  • Exists — 监听节点的创建或删除。
  • Data — 监听节点数据的变化 (由 Get 操作设置) 。

示例：

SELECT * FROM system.zookeeper_watches FORMAT Vertical;

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
• ZooKeeper 指南