Перейти к основному содержанию

​
Описание

Таблица существует только при настроенном ClickHouse Keeper или ZooKeeper. Таблица system.zookeeper предоставляет данные из кластеров Keeper, определённых в конфигурации. Запрос должен содержать либо условие path =, либо условие path IN в предложении WHERE, как показано ниже. Это путь к дочерним узлам, данные которых вы хотите получить. Запрос 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) — Идентификатор транзакции, создавшей узел.
  • mzxid (Int64) — Идентификатор транзакции, которая последней изменила узел.
  • pzxid (Int64) — Идентификатор транзакции, которая последней удалила или добавила дочерние узлы.
  • ctime (DateTime) — Время создания узла.
  • mtime (DateTime) — Время последнего изменения узла.
  • version (Int32) — Версия узла: количество изменений узла.
  • cversion (Int32) — Количество добавленных или удалённых дочерних узлов.
  • aversion (Int32) — Количество изменений ACL.
  • ephemeralOwner (Int64) — Для эфемерных узлов — идентификатор сеанса, которому принадлежит этот узел.
Пример: 
SELECT *
FROM system.zookeeper
WHERE path = '/clickhouse/tables/01-08/visits/replicas'
FORMAT Vertical

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
Последнее изменение 10 июня 2026 г.