system.zookeeper_connection

仅在配置了 ZooKeeper 时才存在的系统表。显示当前与 ZooKeeper 的连接（包括辅助 ZooKeepers）。

在 ClickHouse Cloud 中查询

此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 clusterAllReplicas 函数。更多详情请参见此处。

​

说明

如果未配置 ZooKeeper，则此表不存在。system.zookeeper_connection 表显示当前与 ZooKeeper 的连接 (包括辅助 ZooKeepers) 。每一行都显示一个连接的信息。

​

列

• name (String) — ZooKeeper 集群的名称。
• host (String) — ClickHouse 连接到的 ZooKeeper 节点的主机名/IP。
• port (UInt16) — 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(‘FILTERED_LIST’ = 0, ‘MULTI_READ’ = 1, ‘CHECK_NOT_EXISTS’ = 2, ‘CREATE_IF_NOT_EXISTS’ = 3, ‘REMOVE_RECURSIVE’ = 4, ‘MULTI_WATCHES’ = 5, ‘CHECK_STAT’ = 6, ‘PERSISTENT_WATCHES’ = 7, ‘CREATE_WITH_STATS’ = 8, ‘TRY_REMOVE’ = 9, ‘LIST_WITH_STAT_AND_DATA’ = 10, ‘GET_CHILDREN_RECURSIVE’ = 11, ‘CREATE_TTL’ = 12, ‘CREATE_CONTAINER’ = 13, ‘MAX_REQUEST_SIZE’ = 14))) — 已启用的功能开关。仅适用于 ClickHouse Keeper。
• availability_zone (String) — 可用区
• session_timeout_ms (UInt64) — 会话超时时间 (以毫秒为单位)
• last_zxid_seen (Int64) — 当前会话看到的最后一个 zxid。

​

示例

SELECT
    name,
    host,
    port,
    index,
    connected_time,
    session_uptime_elapsed_seconds,
    is_expired,
    keeper_api_version,
    client_id,
    xid,
    enabled_feature_flags,
    availability_zone
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        │
└─────────┴───────────┴──────┴───────┴─────────────────────┴────────────────────────────────┴────────────┴────────────────────┴───────────┴─────┴──────────────────────────────────────────────────────────────────────────┴───────────────────┘