> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 显示 ZooKeeper 连接（包括辅助 ZooKeepers）的历史。

# system.zookeeper_connection_log

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

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

<div id="description">
  ## 描述
</div>

`system.zookeeper_connection_log` 表显示 ZooKeeper 连接 (包括辅助 ZooKeepers) 的历史记录。每一行都表示一个与连接相关的事件信息。

<Note>
  该表不包含因服务器关闭而导致的断开连接事件。
</Note>

<div id="columns">
  ## 列
</div>

* `hostname` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 与 ZooKeeper 建立或断开连接的服务器的主机名。
* `type` ([Enum8('Connected' = 0, 'Disconnected' = 1)](/zh/reference/data-types/enum)) — 事件类型。可能的值：Connected、Disconnected。
* `event_date` ([Date](/zh/reference/data-types/date)) — 条目的日期。
* `event_time` ([DateTime](/zh/reference/data-types/datetime)) — 条目的时间
* `event_time_microseconds` ([DateTime64(6)](/zh/reference/data-types/datetime64)) — 精确到微秒的条目时间。
* `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` ([UInt8](/zh/reference/data-types/int-uint)) — ClickHouse 所连接或断开连接的 ZooKeeper 节点的索引。该索引来自 ZooKeeper 配置。
* `client_id` ([Int64](/zh/reference/data-types/int-uint)) — 连接的会话 ID。
* `keeper_api_version` ([UInt8](/zh/reference/data-types/int-uint)) — Keeper API 版本。
* `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))](/zh/reference/data-types/array)) — 已启用的功能开关。仅适用于 ClickHouse Keeper。
* `availability_zone` ([String](/zh/reference/data-types/string)) — 可用区
* `reason` ([LowCardinality(String)](/zh/reference/data-types/lowcardinality)) — 连接或断开连接的原因。

示例：

```sql theme={null}
SELECT * FROM system.zookeeper_connection_log;
```

```text theme={null}
┌─hostname─┬─type─────────┬─event_date─┬──────────event_time─┬────event_time_microseconds─┬─name───────────────┬─host─┬─port─┬─index─┬─client_id─┬─keeper_api_version─┬─enabled_feature_flags───────────────────────────────────────────────────────────────────────┬─availability_zone─┬─reason──────────────┐
 1. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:35 │ 2025-05-12 19:49:35.713067 │ zk_conn_log_test_4 │ zoo2 │ 2181 │     0 │        10 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Initialization      │
 2. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:23 │ 2025-05-12 19:49:23.981570 │ default            │ zoo1 │ 2181 │     0 │         4 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Initialization      │
 3. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:28 │ 2025-05-12 19:49:28.104021 │ default            │ zoo1 │ 2181 │     0 │         5 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Initialization      │
 4. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.459251 │ zk_conn_log_test_2 │ zoo2 │ 2181 │     0 │         6 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Initialization      │
 5. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.574312 │ zk_conn_log_test_3 │ zoo3 │ 2181 │     0 │         7 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Initialization      │
 6. │ node     │ Disconnected │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.909890 │ default            │ zoo1 │ 2181 │     0 │         5 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Config changed      │
 7. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.909895 │ default            │ zoo2 │ 2181 │     0 │         8 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Config changed      │
 8. │ node     │ Disconnected │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.912010 │ zk_conn_log_test_2 │ zoo2 │ 2181 │     0 │         6 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Config changed      │
 9. │ node     │ Connected    │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.912014 │ zk_conn_log_test_2 │ zoo3 │ 2181 │     0 │         9 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Config changed      │
10. │ node     │ Disconnected │ 2025-05-12 │ 2025-05-12 19:49:29 │ 2025-05-12 19:49:29.912061 │ zk_conn_log_test_3 │ zoo3 │ 2181 │     0 │         7 │                  0 │ ['FILTERED_LIST','MULTI_READ','CHECK_NOT_EXISTS','CREATE_IF_NOT_EXISTS','REMOVE_RECURSIVE'] │                   │ Removed from config │
    └──────────┴──────────────┴────────────┴─────────────────────┴────────────────────────────┴────────────────────┴──────┴──────┴───────┴───────────┴────────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────┴───────────────────┴─────────────────────┘
```