mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-15 10:52:30 +00:00
133 lines
7.2 KiB
Markdown
133 lines
7.2 KiB
Markdown
---
|
|
slug: /zh/operations/system-tables/zookeeper_log
|
|
---
|
|
# system.zookeeper_log {#system-zookeeper_log}
|
|
|
|
此表包含有关对 ZooKeeper 服务器的请求及其响应的参数的信息.
|
|
|
|
对于请求,只填充有请求参数的列,其余列填充默认值 (`0` or `NULL`). 当响应到达时,来自响应的数据被添加到其他列.
|
|
|
|
带有请求参数的列:
|
|
|
|
- `type` ([Enum](../../sql-reference/data-types/enum.md)) — ZooKeeper 客户端中的事件类型. 可以具有以下值之一:
|
|
- `Request` — 请求已发送.
|
|
- `Response` — 已收到回复.
|
|
- `Finalize` — 连接丢失, 未收到响应.
|
|
- `event_date` ([Date](../../sql-reference/data-types/date.md)) — 事件发生的日期.
|
|
- `event_time` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — 事件发生的日期和时间.
|
|
- `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — 用于发出请求的 ZooKeeper 服务器的 IP 地址.
|
|
- `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — 用于发出请求的 ZooKeeper 服务器的端口.
|
|
- `session_id` ([Int64](../../sql-reference/data-types/int-uint.md)) — ZooKeeper 服务器为每个连接设置的会话 ID.
|
|
- `xid` ([Int32](../../sql-reference/data-types/int-uint.md)) — 会话中请求的 ID. 这通常是一个连续的请求编号. 请求行和配对的 `response`/`finalize` 行相同.
|
|
- `has_watch` ([UInt8](../../sql-reference/data-types/int-uint.md)) — 请求是否设置了 [watch](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html#ch_zkWatches) .
|
|
- `op_num` ([Enum](../../sql-reference/data-types/enum.md)) — 请求或响应的类型.
|
|
- `path` ([String](../../sql-reference/data-types/string.md)) — 请求中指定的 ZooKeeper 节点的路径, 如果请求不需要指定路径, 则为空字符串.
|
|
- `data` ([String](../../sql-reference/data-types/string.md)) — 写入 ZooKeeper 节点的数据(对于 `SET` 和 `CREATE` 请求 - 请求想要写入的内容,对于 `GET` 请求的响应 - 读取的内容)或空字符串.
|
|
- `is_ephemeral` ([UInt8](../../sql-reference/data-types/int-uint.md)) — ZooKeeper 节点是否被创建为 [ephemeral](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html#Ephemeral+Nodes).
|
|
- `is_sequential` ([UInt8](../../sql-reference/data-types/int-uint.md)) — ZooKeeper 节点是否被创建为 [sequential](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html#Sequence+Nodes+--+Unique+Naming).
|
|
- `version` ([Nullable(Int32)](../../sql-reference/data-types/nullable.md)) — 请求执行时期望的 ZooKeeper 节点的版本. 这支持`CHECK`、`SET`、`REMOVE`请求(如果请求不检查版本, 则为相关的`-1`或不支持版本检查的其他请求的`NULL`).
|
|
- `requests_size` ([UInt32](../../sql-reference/data-types/int-uint.md)) —多请求中包含的请求数(这是一个特殊的请求,由几个连续的普通请求组成, 并以原子方式执行). 多请求中包含的所有请求都将具有相同的 `xid`.
|
|
- `request_idx` ([UInt32](../../sql-reference/data-types/int-uint.md)) — 包含在多请求中的请求数(对于多请求 — `0`,然后从 `1` 开始).
|
|
|
|
带有请求响应参数的列:
|
|
|
|
- `zxid` ([Int64](../../sql-reference/data-types/int-uint.md)) — ZooKeeper 事务 ID. ZooKeeper 服务器响应成功执行的请求而发出的序列号(`0` 表示请求没有执行/返回错误/客户端不知道请求是否被执行).
|
|
- `error` ([Nullable(Enum)](../../sql-reference/data-types/nullable.md)) — 错误代码. 可以有很多值, 这里只是其中的一些:
|
|
- `ZOK` — 请求被安全执行.
|
|
- `ZCONNECTIONLOSS` — 连接丢失.
|
|
- `ZOPERATIONTIMEOUT` — 请求执行超时已过期.
|
|
- `ZSESSIONEXPIRED` — 会话已过期.
|
|
- `NULL` — 请求完成.
|
|
- `watch_type` ([Nullable(Enum)](../../sql-reference/data-types/nullable.md)) — `watch` 事件的类型(对于带有 `op_num` = `Watch` 的响应), 对于其余响应:`NULL`.
|
|
- `watch_state` ([Nullable(Enum)](../../sql-reference/data-types/nullable.md)) — `watch` 事件的状态(对于带有 `op_num` = `Watch` 的响应), 对于其余响应:`NULL`.
|
|
- `path_created` ([String](../../sql-reference/data-types/string.md)) — 创建的 ZooKeeper 节点的路径(用于响应 `CREATE` 请求),如果节点被创建为 `sequential`, 则可能与 `path` 不同.
|
|
- `stat_czxid` ([Int64](../../sql-reference/data-types/int-uint.md)) — 导致创建此 ZooKeeper 节点的更改的 `zxid`.
|
|
- `stat_mzxid` ([Int64](../../sql-reference/data-types/int-uint.md)) — 最后一次修改该ZooKeeper节点的 `zxid`.
|
|
- `stat_pzxid` ([Int64](../../sql-reference/data-types/int-uint.md)) — 最后一次修改该ZooKeeper节点的子节点的事务ID
|
|
- `stat_version` ([Int32](../../sql-reference/data-types/int-uint.md)) — 此 ZooKeeper 节点的数据更改次数.
|
|
- `stat_cversion` ([Int32](../../sql-reference/data-types/int-uint.md)) — 此 ZooKeeper 节点的子节点的更改次数.
|
|
- `stat_dataLength` ([Int32](../../sql-reference/data-types/int-uint.md)) — 这个 ZooKeeper 节点的数据字段的长度.
|
|
- `stat_numChildren` ([Int32](../../sql-reference/data-types/int-uint.md)) — 此 ZooKeeper 节点的子节点数.
|
|
- `children` ([Array(String)](../../sql-reference/data-types/array.md)) — ZooKeeper 子节点列表(用于响应 `LIST` 请求).
|
|
|
|
**示例**
|
|
|
|
查询:
|
|
|
|
``` sql
|
|
SELECT * FROM system.zookeeper_log WHERE (session_id = '106662742089334927') AND (xid = '10858') FORMAT Vertical;
|
|
```
|
|
|
|
结果:
|
|
|
|
``` text
|
|
Row 1:
|
|
──────
|
|
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']
|
|
```
|
|
|
|
**另请参阅**
|
|
|
|
- [ZooKeeper](../../operations/tips.md#zookeeper)
|
|
- [ZooKeeper 指南](https://zookeeper.apache.org/doc/r3.3.3/zookeeperProgrammers.html)
|