服务器数据包

值	名称	描述
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