> ## 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.

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

# system.zookeeper_connection

<Info>
  **在 ClickHouse Cloud 中查询**

  此系统表中的数据分别保存在 ClickHouse Cloud 各节点的本地。因此，如需查看所有数据的完整情况，需要使用 `clusterAllReplicas` 函数。更多详情请参见[此处](/zh/reference/system-tables/overview#system-tables-in-clickhouse-cloud)。
</Info>

## 说明

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

## 列

* `name` ([String](/zh/reference/data-types/string)) — ZooKeeper 集群的名称。
* `host` ([String](/zh/reference/data-types/string)) — ClickHouse 连接到的 ZooKeeper 节点的主机名/IP。
* `port` ([UInt16](/zh/reference/data-types/int-uint)) — ClickHouse 连接到的 ZooKeeper 节点的端口。
* `index` ([Nullable(UInt8)](/zh/reference/data-types/nullable)) — ClickHouse 连接到的 ZooKeeper 节点的索引。该索引来自 ZooKeeper 配置。如果未连接，此列为 NULL。
* `connected_time` ([DateTime](/zh/reference/data-types/datetime)) — 连接建立的时间。
* `session_uptime_elapsed_seconds` ([UInt64](/zh/reference/data-types/int-uint)) — 自连接建立以来经过的秒数。
* `is_expired` ([UInt8](/zh/reference/data-types/int-uint)) — 当前连接是否已过期。
* `keeper_api_version` ([UInt8](/zh/reference/data-types/int-uint)) — Keeper API 版本。
* `client_id` ([Int64](/zh/reference/data-types/int-uint)) — 该连接的会话 ID。
* `xid` ([Int64](/zh/reference/data-types/int-uint)) — 当前会话的 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))](/zh/reference/data-types/array)) — 已启用的功能开关。仅适用于 ClickHouse Keeper。
* `availability_zone` ([String](/zh/reference/data-types/string)) — 可用区
* `session_timeout_ms` ([UInt64](/zh/reference/data-types/int-uint)) — 会话超时时间 (以毫秒为单位)
* `last_zxid_seen` ([Int64](/zh/reference/data-types/int-uint)) — 当前会话看到的最后一个 zxid。

## 示例

```sql theme={null}
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;
```

```text theme={null}
┌─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        │
└─────────┴───────────┴──────┴───────┴─────────────────────┴────────────────────────────────┴────────────┴────────────────────┴───────────┴─────┴──────────────────────────────────────────────────────────────────────────┴───────────────────┘
```