Таблица существует только при настроенном 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) — Для эфемерных узлов — идентификатор сеанса, которому принадлежит этот узел.
Пример:
Последнее изменение 2 июля 2026 г.
