跳转到主要内容
名称描述
0Hello服务器握手响应
1Data客户端数据相同
2Exception查询处理异常
3Progress查询进度
4PongPing 响应
5EndOfStream所有数据包均已传输完毕
6ProfileInfo性能分析数据
7Totals总计值
8Extremes极值 (最小值、最大值)
9TablesStatusResponse对 TableStatus 请求的响应
10日志查询系统日志
11TableColumns列描述
12UUIDs唯一 parts ID 的列表
13ReadTaskRequestString (UUID) ,用于描述需要下一个任务的请求
14ProfileEvents来自服务器的 profile events 数据包
DataTotalsExtremes 可以压缩。

Hello

客户端 hello 的响应。
字段类型描述
nameStringClickhouse服务器名称
version_majorUVarInt21服务器主版本号
version_minorUVarInt12服务器次版本号
revisionUVarInt54452服务器修订号
tzStringEurope/Moscow服务器时区
display_nameStringClickhouseUI 中显示的服务器名称
version_patchUVarInt3服务器补丁版本

Exception

查询处理期间的服务器异常。
字段类型描述
codeInt3260参见 ErrorCodes.cpp
nameStringDB::Exception服务器主版本
messageStringDB::Exception: Table X doesn't exist服务器次版本
stack_traceString~C++ 栈跟踪
nestedBooltrue更多错误
可以是连续的异常列表,直到 nestedfalse

Progress

服务器会定期报告查询执行进度。
报告的 Progress 为 增量值。如需总计,请在客户端累加。
字段类型描述
rowsUVarInt65535行数
bytesUVarInt871799字节数
total_rowsUVarInt0总行数
wrote_rowsUVarInt0来自客户端的行数
wrote_bytesUVarInt0来自客户端的字节数

Pong

客户端 Ping的响应,不包含数据包主体。

流结束

不会再发送更多 Data 数据包,查询结果已从服务器完整流式传输到客户端。 无数据包主体。

Profile 信息

字段类型
rowsUVarInt
blocksUVarInt
bytesUVarInt
applied_limitBool
rows_before_limitUVarInt
calculated_rows_before_limitBool

日志

包含服务器日志的数据块
编码为由多列组成的数据块,但永不压缩。
类型
timeDateTime
time_microUInt32
host_nameString
query_idString
thread_idUInt64
priorityInt8
sourceString
textString

Profile events

包含 profile events 的数据块
编码为由列组成的数据块,但不会被压缩。value 的类型取决于服务器修订版本,为 UInt64Int64
类型
host_nameString
current_timeDateTime
thread_idUInt64
typeInt8
nameString
valueUInt64 or Int64
最后修改于 2026年6月10日