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

> ClickHouse Keeper または ZooKeeper が設定されている場合にのみ存在するシステムテーブルです。 設定で定義された Keeper クラスターのデータを参照できます。

# system.zookeeper

## 説明

ClickHouse Keeper または ZooKeeper が設定されていない場合、このテーブルは存在しません。`system.zookeeper` テーブルは、設定で定義された Keeper クラスターのデータを参照できます。
以下に示すように、クエリの `WHERE` 句には `path =` 条件または `path IN` 条件のいずれかを指定する必要があります。これは、データを取得したい子ノードの path に対応します。

クエリ `SELECT * FROM system.zookeeper WHERE path = '/clickhouse'` は、`/clickhouse` ノード上のすべての子ノードのデータを出力します。
すべてのルートノードのデータを出力するには、path = '/' と指定します。
`path` で指定した path が存在しない場合は、例外がスローされます。

クエリ `SELECT * FROM system.zookeeper WHERE path IN ('/', '/clickhouse')` は、`/` ノードおよび `/clickhouse` ノード上のすべての子ノードのデータを出力します。
指定した `path` のコレクションに存在しない path が含まれている場合は、例外がスローされます。
これは、Keeper の path クエリをバッチで実行する際に使用できます。

クエリ `SELECT * FROM system.zookeeper WHERE path = '/clickhouse' AND zookeeperName = 'auxiliary_cluster'` は、`auxiliary_cluster` ZooKeeper クラスター内のデータを出力します。
指定した `auxiliary_cluster` が存在しない場合は、例外がスローされます。

## カラム

* `name` ([String](/ja/reference/data-types/string)) — ノードの名前。
* `value` ([String](/ja/reference/data-types/string)) — ノードの値。
* `zookeeperName` ([String](/ja/reference/data-types/string)) — デフォルトまたは補助的な ZooKeeper クラスターの名前。
* `czxid` ([Int64](/ja/reference/data-types/int-uint)) — ノードを作成したトランザクションの ID。
* `mzxid` ([Int64](/ja/reference/data-types/int-uint)) — ノードを最後に変更したトランザクションの ID。
* `ctime` ([DateTime](/ja/reference/data-types/datetime)) — ノードの作成時刻。
* `mtime` ([DateTime](/ja/reference/data-types/datetime)) — ノードの最終更新時刻。
* `version` ([Int32](/ja/reference/data-types/int-uint)) — ノードのバージョン: ノードが変更された回数。
* `cversion` ([Int32](/ja/reference/data-types/int-uint)) — 追加または削除された子孫の数。
* `aversion` ([Int32](/ja/reference/data-types/int-uint)) — ACL の変更回数。
* `ephemeralOwner` ([Int64](/ja/reference/data-types/int-uint)) — エフェメラルノードの場合、このノードを所有するセッションの ID。
* `dataLength` ([Int32](/ja/reference/data-types/int-uint)) — 値のサイズ。
* `numChildren` ([Int32](/ja/reference/data-types/int-uint)) — 子孫の数。
* `pzxid` ([Int64](/ja/reference/data-types/int-uint)) — 子孫を最後に削除または追加したトランザクションの ID。
* `path` ([String](/ja/reference/data-types/string)) — ノードへのパス。

## 例

```sql theme={null}
SELECT *
FROM system.zookeeper
WHERE path = '/clickhouse/tables/01-08/visits/replicas'
FORMAT Vertical
```

```text theme={null}
Row 1:
──────
name:           example01-08-1
value:
czxid:          932998691229
mzxid:          932998691229
ctime:          2015-03-27 16:49:51
mtime:          2015-03-27 16:49:51
version:        0
cversion:       47
aversion:       0
ephemeralOwner: 0
dataLength:     0
numChildren:    7
pzxid:          987021031383
path:           /clickhouse/tables/01-08/visits/replicas

Row 2:
──────
name:           example01-08-2
value:
czxid:          933002738135
mzxid:          933002738135
ctime:          2015-03-27 16:57:01
mtime:          2015-03-27 16:57:01
version:        0
cversion:       37
aversion:       0
ephemeralOwner: 0
dataLength:     0
numChildren:    7
pzxid:          987021252247
path:           /clickhouse/tables/01-08/visits/replicas
```
