服务器数据包
| 值 | 名称 | 描述 |
|---|---|---|
| 0 | Hello | 服务器握手响应 |
| 1 | Data | 与客户端数据相同 |
| 2 | Exception | 查询处理异常 |
| 3 | Progress | 查询进度 |
| 4 | Pong | Ping 响应 |
| 5 | EndOfStream | 所有数据包已传输 |
| 6 | ProfileInfo | 性能分析数据 |
| 7 | Totals | 总值 |
| 8 | Extremes | 极值 (最小值,最大值) |
| 9 | TablesStatusResponse | TableStatus 请求的响应 |
| 10 | Log | 查询系统日志 |
| 11 | TableColumns | 列描述 |
| 12 | UUIDs | 唯一部分 ID 列表 |
| 13 | ReadTaskRequest | 字符串 (UUID) 描述了需要下一个任务的请求 |
| 14 | ProfileEvents | 包含来自服务器的性能分析事件的数据包 |
Data、Totals 和 Extremes 可以被压缩。
Hello
对 客户端 hello 的响应。
| 字段 | 类型 | 值 | 描述 |
|---|---|---|---|
| 名称 | String | Clickhouse | 服务器名称 |
| version_major | UVarInt | 21 | 服务器主版本 |
| version_minor | UVarInt | 12 | 服务器次版本 |
| revision | UVarInt | 54452 | 服务器修订号 |
| tz | String | Europe/Moscow | 服务器时区 |
| display_name | String | Clickhouse | 用于 UI 的服务器名称 |
| version_patch | UVarInt | 3 | 服务器补丁版本 |
Exception
查询处理期间的服务器异常。
| 字段 | 类型 | 值 | 描述 |
|---|---|---|---|
| 代码 | Int32 | 60 | 请参阅 ErrorCodes.cpp。 |
| 名称 | String | DB::Exception | 服务器主版本 |
| 消息 | String | DB::Exception:表 X 不存在 | 服务器次版本 |
| stack_trace | String | ~ | C++ 堆栈跟踪 |
| nested | Bool | true | 更多错误 |
可以是异常的连续列表,直到 nested 为 false。
Progress
服务器定期报告的查询执行进度。
提示
进度以增量报告。对于总数,请在客户端累积。
| 字段 | 类型 | 值 | 描述 |
|---|---|---|---|
| rows | UVarInt | 65535 | 行数 |
| bytes | UVarInt | 871799 | 字节数 |
| total_rows | UVarInt | 0 | 总行数 |
| wrote_rows | UVarInt | 0 | 来自客户端的行数 |
| wrote_bytes | UVarInt | 0 | 来自客户端的字节数 |
Pong
对 客户端 ping 的响应,没有数据包体。
流结束
将不再发送 Data 数据包,查询结果已从服务器完全流式传输到客户端。
没有数据包体。
Profile info
| 字段 | 类型 |
|---|---|
| rows | UVarInt |
| blocks | UVarInt |
| bytes | UVarInt |
| applied_limit | Bool |
| rows_before_limit | UVarInt |
| calculated_rows_before_limit | Bool |
Log
数据块,包含服务器日志。
提示
编码为列的 数据块,但从不压缩。
| 列 | 类型 |
|---|---|
| time | DateTime |
| time_micro | UInt32 |
| host_name | String |
| query_id | String |
| thread_id | UInt64 |
| priority | Int8 |
| source | String |
| text | String |
Profile events
数据块,包含性能分析事件。
提示
编码为列的 数据块,但从不压缩。
value 类型是 UInt64 或 Int64,具体取决于服务器修订号。
| 列 | 类型 |
|---|---|
| host_name | String |
| current_time | DateTime |
| thread_id | UInt64 |
| 类型 | Int8 |
| 名称 | String |
| 值 | UInt64 或 Int64 |