跳到主要内容
跳到主要内容

服务器数据包

名称描述
0Hello服务器握手响应
1Data客户端数据 相同
2Exception查询处理异常
3Progress查询进度
4PongPing 响应
5EndOfStream所有数据包已传输
6ProfileInfo性能分析数据
7Totals总值
8Extremes极端值(最小值,最大值)
9TablesStatusResponse对 TableStatus 请求的响应
10Log查询系统日志
11TableColumns列描述
12UUIDs唯一部分 ID 列表
13ReadTaskRequest字符串(UUID)描述请求需要的下一个任务
14ProfileEvents来自服务器的性能事件数据包

DataTotalsExtremes 可以被压缩。

Hello

客户端 hello 的响应。

字段类型描述
nameStringClickhouse服务器名称
version_majorUVarInt21服务器主版本
version_minorUVarInt12服务器次版本
revisionUVarInt54452服务器修订号
tzStringEurope/Moscow服务器时区
display_nameStringClickhouse用户界面的服务器名称
version_patchUVarInt3服务器补丁版本

Exception

查询处理期间的服务器异常。

字段类型描述
codeInt3260参见 ErrorCodes.cpp
nameStringDB::Exception服务器主要版本
messageStringDB::Exception: Table X doesn't exist服务器次版本
stack_traceString~C++ 堆栈跟踪
nestedBooltrue更多错误

可以是连续的异常列表,直到 nestedfalse

Progress

由服务器定期报告的查询执行进度。

提示

进度以 增量 的形式报告。对于总计,请在客户端进行累积。

字段类型描述
rowsUVarInt65535行数
bytesUVarInt871799字节数
total_rowsUVarInt0总行数
wrote_rowsUVarInt0客户端发送的行数
wrote_bytesUVarInt0客户端发送的字节数

Pong

客户端 ping 的响应,没有数据包正文。

End of stream

将不再发送 Data 数据包,查询结果已完全从服务器流向客户端。

没有数据包正文。

Profile info

字段类型
rowsUVarInt
blocksUVarInt
bytesUVarInt
applied_limitBool
rows_before_limitUVarInt
calculated_rows_before_limitBool

Log

数据块包含服务器日志。

提示

编码为 数据块 的列,但永远不会被压缩。

列名类型
timeDateTime
time_microUInt32
host_nameString
query_idString
thread_idUInt64
priorityInt8
sourceString
textString

Profile events

数据块包含性能事件。

提示

编码为 数据块 的列,但永远不会被压缩。

value 类型为 UInt64Int64,具体取决于服务器修订号。

列名类型
host_nameString
current_timeDateTime
thread_idUInt64
typeInt8
nameString
valueUInt64 或 Int64