system.zookeeper_connection

在 ClickHouse Cloud 中进行查询

该系统表中的数据保存在 ClickHouse Cloud 中每个节点的本地。因此，如需获得所有数据的完整视图，需要使用 clusterAllReplicas 函数。更多详情请参阅此处。

如果未配置 ZooKeeper，则该表不存在。system.zookeeper_connection 表显示当前到 ZooKeeper 的连接（包括辅助 ZooKeeper）。每一行包含一个连接的信息。

列：

name (String) — ZooKeeper 集群的名称。
host (String) — ClickHouse 已连接的 ZooKeeper 节点的主机名/IP。
port (UIn16) — ClickHouse 已连接的 ZooKeeper 节点的端口。
index (Nullable(UInt8)) — ClickHouse 已连接的 ZooKeeper 节点的索引。该索引来源于 ZooKeeper 的配置。如果未连接，此列为 NULL。
connected_time (DateTime) — 建立连接的时间。
session_uptime_elapsed_seconds (UInt64) — 自连接建立以来经过的秒数。
is_expired (UInt8) — 当前连接是否已过期。
keeper_api_version (UInt8) — Keeper API 版本。
client_id (Int64) — 连接的会话 ID。
xid (Int64) — 当前会话的 XID。
enabled_feature_flags (Array(Enum16)) — 已启用的功能标志。仅适用于 ClickHouse Keeper。可能的取值为 FILTERED_LIST、MULTI_READ、CHECK_NOT_EXISTS、CREATE_IF_NOT_EXISTS、REMOVE_RECURSIVE。
availability_zone (String) — 可用区。
session_timeout_ms (UInt64) — 会话超时时间（毫秒）。
last_zxid_seen (Int64) — 当前会话最后看到的 zxid。

示例：

SELECT * FROM system.zookeeper_connection;

┌─name────┬─host──────┬─port─┬─index─┬──────connected_time─┬─session_uptime_elapsed_seconds─┬─is_expired─┬─keeper_api_version─┬─client_id─┬─xid─┬─enabled_feature_flags────────────────────────────────────────────────────┬─availability_zone─┐
│ default │ 127.0.0.1 │ 2181 │     0 │ 2025-04-10 14:30:00 │                            943 │          0 │                  0 │       420 │  69 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS'] │ eu-west-1b        │
└─────────┴───────────┴──────┴───────┴─────────────────────┴────────────────────────────────┴────────────┴────────────────────┴───────────┴─────┴──────────────────────────────────────────────────────────────────────────┴───────────────────┘