system.zookeeper_connection_log 시스템 테이블

system.zookeeper_connection_log 테이블은 ZooKeeper 연결(보조 ZooKeeper 포함)의 이력을 보여줘요. 각 행은 연결에 관한 하나의 이벤트에 대한 정보를 보여줘요. 서버 종료로 인한 연결 해제 이벤트는 포함하지 않아요. 이 테이블은 언제든지 안전하게 truncate 하거나 drop 할 수 있어요.

출처: 문서

본문

ClickHouse Cloud에서의 조회 — 이 시스템 테이블의 데이터는 ClickHouse Cloud에서 각 노드에 로컬로 저장돼요. 따라서 모든 데이터의 완전한 뷰를 얻으려면 clusterAllReplicas 함수가 필요해요. 자세한 내용은 여기 를 참고하세요.

Description

‘system.zookeeper_connection_log’ 테이블은 ZooKeeper 연결(보조 ZooKeeper 포함)의 이력을 보여줘요. 각 행은 연결에 관한 하나의 이벤트에 대한 정보를 보여줘요. 이 테이블은 서버 종료로 인한 연결 해제 이벤트를 포함하지 않아요. 이 테이블은 언제든지 안전하게 truncate 하거나 drop 할 수 있어요.

Columns

hostname (LowCardinality(String)) — ZooKeeper에 연결되었거나 연결에서 해제된 서버의 호스트 이름이에요.
clickhouse_version (LowCardinality(String)) — 이 행을 만든 ClickHouse 서버의 버전이에요.
system_processor (LowCardinality(String)) — 이 행을 만든 ClickHouse 서버의 CPU 아키텍처예요.
type (Enum8(‘Connected’ = 0, ‘Disconnected’ = 1)) — 이벤트의 유형이에요. 가능한 값: Connected, Disconnected.
event_date (Date) — 항목의 날짜예요.
event_time (DateTime) — 항목의 시간이에요.
event_time_microseconds (DateTime64(6)) — 마이크로초 정밀도의 항목 시간이에요.
name (String) — ZooKeeper 클러스터의 이름이에요.
host (String) — ClickHouse가 연결하거나 연결에서 해제한 ZooKeeper 노드의 호스트명/IP예요.
port (UInt16) — ClickHouse가 연결하거나 연결에서 해제한 ZooKeeper 노드의 포트예요.
index (UInt8) — ClickHouse가 연결하거나 연결에서 해제한 ZooKeeper 노드의 인덱스예요. 인덱스는 ZooKeeper 구성에서 가져와요.
client_id (Int64) — 연결의 세션 ID예요.
keeper_api_version (UInt8) — 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, ‘CREATE_TTL’ = 12, ‘CREATE_CONTAINER’ = 13, ‘MAX_REQUEST_SIZE’ = 14))) — 활성화된 기능 플래그예요. ClickHouse Keeper에만 적용돼요.
availability_zone (String) — 가용 영역이에요.
reason (LowCardinality(String)) — 연결 또는 연결 해제의 이유예요.

Examples

SELECT * FROM system.zookeeper_connection_log;

┌─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 │
    └──────────┴──────────────┴────────────┴─────────────────────┴────────────────────────────┴────────────────────┴──────┴──────┴───────┴───────────┴────────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────┴───────────────────┴─────────────────────┘