メインコンテンツまでスキップ
メインコンテンツまでスキップ

サーバーパケット

valuenamedescription
0Helloサーバーハンドシェイクレスポンス
1Dataクライアントデータ と同様
2Exceptionクエリ処理中の例外
3Progressクエリの進捗
4PongPingレスポンス
5EndOfStreamすべてのパケットが転送されました
6ProfileInfoプロファイリングデータ
7Totals合計値
8Extremes極値(最小、最大)
9TablesStatusResponseTableStatusリクエストへのレスポンス
10Logクエリシステムログ
11TableColumnsカラムの説明
12UUIDs一意のパーツIDのリスト
13ReadTaskRequest次のタスクが必要なリクエストを説明する文字列(UUID)
14ProfileEventsサーバーからのプロファイルイベントを含むパケット

DataTotals および Extremes は圧縮可能です。

Hello

クライアントhello へのレスポンス。

fieldtypevaluedescription
nameStringClickhouseサーバー名
version_majorUVarInt21サーバーのメジャーバージョン
version_minorUVarInt12サーバーのマイナーバージョン
revisionUVarInt54452サーバーのリビジョン
tzStringEurope/Moscowサーバーのタイムゾーン
display_nameStringClickhouseUI用のサーバー名
version_patchUVarInt3サーバーパッチバージョン

Exception

クエリ処理中のサーバー例外。

fieldtypevaluedescription
codeInt3260ErrorCodes.cpp を参照。
nameStringDB::Exceptionサーバーのメジャーバージョン
messageStringDB::Exception: Table X doesn't existサーバーのマイナーバージョン
stack_traceString~C++スタックトレース
nestedBooltrueさらにエラーがある

nestedfalseになるまで例外が連続して表示される場合があります。

Progress

クエリ実行の進捗がサーバーから定期的に報告されます。

ヒント

進捗はデルタで報告されます。合計値はクライアント側で蓄積してください。

fieldtypevaluedescription
rowsUVarInt65535行数
bytesUVarInt871799バイト数
total_rowsUVarInt0合計行数
wrote_rowsUVarInt0クライアントからの行数
wrote_bytesUVarInt0クライアントからのバイト数

Pong

クライアントpingへのレスポンス、パケット本体はなし。

ストリームの終わり

これ以上のDataパケットは送信されず、クエリ結果はサーバーからクライアントに完全にストリーミングされます。

パケット本体はありません。

プロファイル情報

fieldtype
rowsUVarInt
blocksUVarInt
bytesUVarInt
applied_limitBool
rows_before_limitUVarInt
calculated_rows_before_limitBool

Log

データブロックにサーバーログが含まれています。

ヒント

カラムのデータブロックとしてエンコードされていますが、圧縮されることはありません。

columntype
timeDateTime
time_microUInt32
host_nameString
query_idString
thread_idUInt64
priorityInt8
sourceString
textString

プロファイルイベント

データブロックにプロファイルイベントが含まれています。

ヒント

カラムのデータブロックとしてエンコードされていますが、圧縮されることはありません。

valueの型はサーバーのリビジョンに応じてUInt64またはInt64になります。

columntype
host_nameString
current_timeDateTime
thread_idUInt64
typeInt8
nameString
valueUInt64 or Int64