> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица, содержащая сведения о параметрах запроса к серверу ZooKeeper и его ответе.

# system.zookeeper_log

<div id="description">
  ## Описание
</div>

Эта таблица содержит информацию о параметрах запроса к серверу ZooKeeper и ответа от него.

Для запросов заполняются только столбцы с параметрами запроса, а остальные столбцы получают значения по умолчанию (`0` или `NULL`). Когда приходит ответ, данные из него добавляются в остальные столбцы.

<div id="columns">
  ## Столбцы
</div>

* `hostname` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя хоста сервера, выполняющего запрос.
* `type` ([Enum8('Request' = 1, 'Response' = 2, 'Finalize' = 3)](/ru/reference/data-types/enum)) — Тип события клиента ZooKeeper. Может принимать одно из следующих значений: Request — запрос был отправлен, Response — ответ был получен, Finalize — соединение потеряно, ответ не был получен.
* `event_date` ([Date](/ru/reference/data-types/date)) — Дата события.
* `event_time` ([DateTime64(6)](/ru/reference/data-types/datetime64)) — дата и время, когда произошло событие.
* `thread_id` ([UInt64](/ru/reference/data-types/int-uint)) — Идентификатор потока, выполнившего этот запрос.
* `query_id` ([String](/ru/reference/data-types/string)) — Идентификатор запроса, в контексте которого был выполнен данный запрос.
* `address` ([IPv6](/ru/reference/data-types/ipv6)) — IP-адрес сервера ZooKeeper, к которому был отправлен запрос.
* `port` ([UInt16](/ru/reference/data-types/int-uint)) — Порт сервера ZooKeeper, использованный для выполнения запроса.
* `session_id` ([Int64](/ru/reference/data-types/int-uint)) — Идентификатор сеанса, который сервер ZooKeeper устанавливает для каждого соединения.
* `duration_microseconds` ([UInt64](/ru/reference/data-types/int-uint)) — Время, затраченное ZooKeeper на выполнение запроса.
* `xid` ([Int64](/ru/reference/data-types/int-uint)) — Идентификатор запроса в рамках сеанса. Обычно это последовательный номер запроса. Он одинаков для строки запроса и соответствующей парной строки ответа/finalize.
* `has_watch` ([UInt8](/ru/reference/data-types/int-uint)) — Признак того, установлено ли наблюдение.
* `op_num` ([Enum16('Close' = -11, 'Error' = -1, 'Watch' = 0, 'Create' = 1, 'Remove' = 2, 'Exists' = 3, 'Get' = 4, 'Set' = 5, 'GetACL' = 6, 'SetACL' = 7, 'SimpleList' = 8, 'Sync' = 9, 'Heartbeat' = 11, 'List' = 12, 'Check' = 13, 'Multi' = 14, 'Create2' = 15, 'Reconfig' = 16, 'CheckWatch' = 17, 'RemoveWatch' = 18, 'MultiRead' = 22, 'Auth' = 100, 'SetWatch' = 101, 'SetWatch2' = 105, 'AddWatch' = 106, 'FilteredList' = 500, 'CheckNotExists' = 501, 'CreateIfNotExists' = 502, 'RemoveRecursive' = 503, 'CheckStat' = 504, 'TryRemove' = 505, 'FilteredListWithStatsAndData' = 506, 'ListRecursive' = 507, 'SessionID' = 997)](/ru/reference/data-types/enum)) — Тип запроса или тип ответа.
* `path` ([String](/ru/reference/data-types/string)) — путь к узлу ZooKeeper, указанному в запросе, или пустая строка, если в запросе не требуется указывать путь.
* `data` ([String](/ru/reference/data-types/string)) — данные, записанные в узел ZooKeeper (для запросов SET и CREATE — то, что запрос пытался записать; для ответа на запрос GET — то, что было прочитано), либо пустая строка.
* `is_ephemeral` ([UInt8](/ru/reference/data-types/int-uint)) — Создаётся ли узел ZooKeeper как эфемерный узел.
* `is_sequential` ([UInt8](/ru/reference/data-types/int-uint)) — Создаётся ли узел ZooKeeper как последовательный узел.
* `version` ([Nullable(Int32)](/ru/reference/data-types/nullable)) — Версия узла ZooKeeper, которую запрос ожидает при выполнении. Поддерживается для запросов CHECK, SET, REMOVE (значение — -1, если запрос не проверяет версию, или NULL для других запросов, не поддерживающих проверку версии).
* `requests_size` ([UInt32](/ru/reference/data-types/int-uint)) — Количество запросов, входящих в multi request (это специальный запрос, состоящий из нескольких последовательных обычных запросов и выполняемый атомарно). Все запросы, входящие в multi request, имеют одинаковый xid.
* `request_idx` ([UInt32](/ru/reference/data-types/int-uint)) — Номер запроса, включённого в multi request (для multi request — 0, затем по порядку, начиная с 1).
* `zxid` ([Int64](/ru/reference/data-types/int-uint)) — идентификатор транзакции ZooKeeper. Порядковый номер, выдаваемый сервером ZooKeeper в ответ на успешно выполненный запрос (0, если запрос не был выполнен/вернул ошибку/клиент не знает, был ли запрос выполнен).
* `error` ([Nullable(Enum8('ZNOWATCHER' = -121, 'ZNOTREADONLY' = -119, 'ZSESSIONMOVED' = -118, 'ZNOTHING' = -117, 'ZCLOSING' = -116, 'ZAUTHFAILED' = -115, 'ZINVALIDACL' = -114, 'ZINVALIDCALLBACK' = -113, 'ZSESSIONEXPIRED' = -112, 'ZNOTEMPTY' = -111, 'ZNODEEXISTS' = -110, 'ZNOCHILDRENFOREPHEMERALS' = -108, 'ZBADVERSION' = -103, 'ZNOAUTH' = -102, 'ZNONODE' = -101, 'ZAPIERROR' = -100, 'ZOUTOFMEMORY' = -10, 'ZINVALIDSTATE' = -9, 'ZBADARGUMENTS' = -8, 'ZOPERATIONTIMEOUT' = -7, 'ZUNIMPLEMENTED' = -6, 'ZMARSHALLINGERROR' = -5, 'ZCONNECTIONLOSS' = -4, 'ZDATAINCONSISTENCY' = -3, 'ZRUNTIMEINCONSISTENCY' = -2, 'ZSYSTEMERROR' = -1, 'ZOK' = 0))](/ru/reference/data-types/nullable)) — Код ошибки. Может принимать множество значений, здесь приведены лишь некоторые из них: ZOK — запрос успешно выполнен, ZCONNECTIONLOSS — соединение потеряно, ZOPERATIONTIMEOUT — истёк тайм-аут выполнения запроса, ZSESSIONEXPIRED — срок действия сеанса истёк, NULL — запрос завершён.
* `watch_type` ([Nullable(Enum8('NOTWATCHING' = -2, 'SESSION' = -1, 'CREATED' = 1, 'DELETED' = 2, 'CHANGED' = 3, 'CHILD' = 4))](/ru/reference/data-types/nullable)) — Тип события наблюдения (для ответов с op\_num = Watch); для остальных ответов — NULL.
* `watch_state` ([Nullable(Enum16('AUTH\_FAILED' = -113, 'EXPIRED\_SESSION' = -112, 'CONNECTING' = 1, 'ASSOCIATING' = 2, 'CONNECTED' = 3, 'READONLY' = 5, 'NOTCONNECTED' = 999))](/ru/reference/data-types/nullable)) — статус события наблюдения (для ответов с op\_num = Watch), для остальных ответов: NULL.
* `path_created` ([String](/ru/reference/data-types/string)) — путь к созданному узлу ZooKeeper (в ответах на запрос CREATE); может отличаться от исходного пути, если узел создаётся в последовательном режиме.
* `stat_czxid` ([Int64](/ru/reference/data-types/int-uint)) — zxid изменения, в результате которого был создан этот узел ZooKeeper.
* `stat_mzxid` ([Int64](/ru/reference/data-types/int-uint)) — zxid изменения, которое последним изменило этот узел ZooKeeper.
* `stat_pzxid` ([Int64](/ru/reference/data-types/int-uint)) — Идентификатор транзакции изменения, которая последней изменила дочерние элементы этого узла ZooKeeper.
* `stat_version` ([Int32](/ru/reference/data-types/int-uint)) — Количество изменений данных у этого узла ZooKeeper.
* `stat_cversion` ([Int32](/ru/reference/data-types/int-uint)) — Количество изменений в дочерних узлах этого узла ZooKeeper.
* `stat_dataLength` ([Int32](/ru/reference/data-types/int-uint)) — Длина поля данных этого узла ZooKeeper.
* `stat_numChildren` ([Int32](/ru/reference/data-types/int-uint)) — количество дочерних узлов данного узла ZooKeeper.
* `children` ([Array(String)](/ru/reference/data-types/array)) — список дочерних узлов ZooKeeper (для ответов на запрос LIST).

<div id="example">
  ## Пример
</div>

```sql title="Query" theme={null}
SELECT * FROM system.zookeeper_log WHERE (session_id = '106662742089334927') AND (xid = '10858') FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
hostname:         clickhouse.eu-central1.internal
type:             Request
event_date:       2021-08-09
event_time:       2021-08-09 21:38:30.291792
address:          ::
port:             2181
session_id:       106662742089334927
xid:              10858
has_watch:        1
op_num:           List
path:             /clickhouse/task_queue/ddl
data:
is_ephemeral:     0
is_sequential:    0
version:          ᴺᵁᴸᴸ
requests_size:    0
request_idx:      0
zxid:             0
error:            ᴺᵁᴸᴸ
watch_type:       ᴺᵁᴸᴸ
watch_state:      ᴺᵁᴸᴸ
path_created:
stat_czxid:       0
stat_mzxid:       0
stat_pzxid:       0
stat_version:     0
stat_cversion:    0
stat_dataLength:  0
stat_numChildren: 0
children:         []

Row 2:
──────
type:             Response
event_date:       2021-08-09
event_time:       2021-08-09 21:38:30.292086
address:          ::
port:             2181
session_id:       106662742089334927
xid:              10858
has_watch:        1
op_num:           List
path:             /clickhouse/task_queue/ddl
data:
is_ephemeral:     0
is_sequential:    0
version:          ᴺᵁᴸᴸ
requests_size:    0
request_idx:      0
zxid:             16926267
error:            ZOK
watch_type:       ᴺᵁᴸᴸ
watch_state:      ᴺᵁᴸᴸ
path_created:
stat_czxid:       16925469
stat_mzxid:       16925469
stat_pzxid:       16926179
stat_version:     0
stat_cversion:    7
stat_dataLength:  0
stat_numChildren: 7
children:         ['query-0000000006','query-0000000005','query-0000000004','query-0000000003','query-0000000002','query-0000000001','query-0000000000']
```

<div id="see-also">
  ## См. также
</div>

* [ZooKeeper](/ru/guides/oss/best-practices/tips#zookeeper)
* [Руководство по ZooKeeper](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html)
