system.zookeeper_connection

ZooKeeper が構成されている場合にのみ存在するシステムテーブルです。現在の ZooKeeper への接続（補助的な ZooKeeper を含む）を表示します。

ClickHouse Cloud でのクエリ

このシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータを完全に把握するには、clusterAllReplicas 関数を使用する必要があります。詳細については、こちらを参照してください。

​

説明

ZooKeeper が設定されていない場合、このテーブルは存在しません。system.zookeeper_connection テーブルには、現在の ZooKeeper への接続 (補助的な ZooKeeper を含む) が表示されます。各行には、1 つの接続に関する情報が含まれます。

​

カラム

• 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))) — 有効な feature flags。ClickHouse Keeper にのみ適用されます。
• availability_zone (String) — アベイラビリティゾーン
• session_timeout_ms (UInt64) — セッションの timeout (ミリ秒単位)
• 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        │
└─────────┴───────────┴──────┴───────┴─────────────────────┴────────────────────────────────┴────────────┴────────────────────┴───────────┴─────┴──────────────────────────────────────────────────────────────────────────┴───────────────────┘