system.zookeeper
このテーブルは、ClickHouse Keeper または ZooKeeper が構成されている場合にのみ存在します。system.zookeeper テーブルでは、設定ファイルで定義された Keeper クラスターのデータを参照できます。
クエリには、以下のように WHERE 句で path = 条件、または path IN 条件のいずれかを必ず指定する必要があります。これは、データを取得したい子ノードのパスに対応します。
クエリ SELECT * FROM system.zookeeper WHERE path = '/clickhouse' は、/clickhouse ノード直下のすべての子ノードのデータを出力します。
すべてのルートノードのデータを出力するには、path = '/' と記述します。
'path' で指定したパスが存在しない場合、例外がスローされます。
クエリ SELECT * FROM system.zookeeper WHERE path IN ('/', '/clickhouse') は、/ および /clickhouse ノード直下のすべての子ノードのデータを出力します。
指定した 'path' コレクションの中に存在しないパスが含まれている場合、例外がスローされます。
これは、複数の Keeper パスに対するクエリを一括で実行する用途に使用できます。
クエリ SELECT * FROM system.zookeeper WHERE path = '/clickhouse' AND zookeeperName = 'auxiliary_cluster' は、ZooKeeper クラスター auxiliary_cluster 内のデータを出力します。
指定した 'auxiliary_cluster' が存在しない場合、例外がスローされます。
列:
name(String) — ノード名。path(String) — ノードへのパス。value(String) — ノードの値。zookeeperName(String) — デフォルトまたは補助 ZooKeeper クラスターのうちいずれかの名前。dataLength(Int32) — 値のサイズ。numChildren(Int32) — 子孫ノードの数。czxid(Int64) — ノードを作成したトランザクションの ID。mzxid(Int64) — 直近でノードを変更したトランザクションの ID。pzxid(Int64) — 直近で子孫ノードを削除または追加したトランザクションの ID。ctime(DateTime) — ノード作成時刻。mtime(DateTime) — ノードが最後に変更された時刻。version(Int32) — ノードのバージョン（ノードが変更された回数）。cversion(Int32) — 追加または削除された子孫ノードの数。aversion(Int32) — ACL の変更回数。ephemeralOwner(Int64) — 一時ノードの場合、このノードを所有するセッションの ID。
例:
