メインコンテンツへスキップ
名前説明
0Helloサーバーのハンドシェイク応答
1Dataclient data と同じ
2Exceptionクエリ処理中の例外
3Progressクエリの進捗
4PongPing への応答
5EndOfStreamすべてのパケットの転送完了
6ProfileInfoプロファイリングデータ
7Totals合計値
8Extremes極値 (最小、最大)
9TablesStatusResponseTableStatus リクエストへの応答
10Logクエリのシステムログ
11TableColumnsカラムの説明
12UUIDs一意なパーツ ID の一覧
13ReadTaskRequest次のタスクが必要なリクエストを表す String (UUID)
14ProfileEventsサーバーからのプロファイルイベントを含むパケット
DataTotalsExtremes は圧縮できます。

Hello

client hello への応答。
フィールド説明
nameStringClickhouseサーバー名
version_majorUVarInt21サーバーのメジャーバージョン
version_minorUVarInt12サーバーのマイナーバージョン
revisionUVarInt54452サーバーのリビジョン
tzStringEurope/Moscowサーバーのタイムゾーン
display_nameStringClickhouseUI 用のサーバー名
version_patchUVarInt3サーバーのパッチバージョン

例外

クエリ処理中のサーバー例外。
フィールド説明
codeInt3260ErrorCodes.cpp を参照してください。
nameStringDB::Exceptionサーバーのメジャーバージョン
messageStringDB::Exception: Table X doesn't existサーバーのマイナーバージョン
stack_traceString~C++ のスタックトレース
nestedBooltrueさらにエラーあり
nestedfalse になるまで、例外が連続して並ぶ場合があります。

Progress

サーバーによって定期的に報告されるクエリ実行の Progress。
Progress は差分で報告されます。合計値はクライアント側で累積してください。
フィールド説明
rowsUVarInt65535行数
bytesUVarInt871799バイト数
total_rowsUVarInt0合計行数
wrote_rowsUVarInt0クライアントからの行数
wrote_bytesUVarInt0クライアントからのバイト数

Pong

client ping に対する応答で、パケット本文はありません。

ストリームの終端

これ以上 Data パケットは送信されず、サーバーからクライアントへのクエリ結果のストリーミングは完了しています。 パケット本文はありません。

プロファイル情報

フィールド
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

プロファイルイベント

プロファイルイベントを含むデータブロック
カラムで構成されたデータブロックとしてエンコードされますが、圧縮はされません。value の型は、サーバー のリビジョンに応じて UInt64 または Int64 です。
カラム
host_nameString
current_timeDateTime
thread_idUInt64
typeInt8
nameString
valueUInt64 or Int64
最終更新日 2026年6月10日