본문으로 바로가기
본문으로 바로가기

서버 패킷

valuenamedescription
0Hello서버 핸드셰이크 응답
1Data클라이언트 데이터와 동일
2Exception쿼리 처리 예외
3Progress쿼리 진행 상황
4PongPing 요청에 대한 응답
5EndOfStream모든 패킷이 전송됨
6ProfileInfo프로파일링 데이터
7Totals총계 값
8Extremes극단값(최솟값, 최댓값)
9TablesStatusResponseTableStatus 요청에 대한 응답
10Log쿼리 시스템 로그
11TableColumns컬럼에 대한 설명
12UUIDs고유한 파트 ID 목록
13ReadTaskRequest다음 태스크가 필요한 요청을 설명하는 문자열(UUID)
14ProfileEvents서버의 프로파일 이벤트가 담긴 패킷

Data, Totals, Extremes 패킷은 압축될 수 있습니다.

Hello

client 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가 될 때까지 예외가 연속해서 나열될 수 있습니다.

진행 상황

쿼리 실행 진행 상황이 서버에 의해 주기적으로 보고됩니다.

진행 상황은 **증분(delta)**으로 보고됩니다. 총계를 얻으려면 클라이언트에서 누적하십시오.

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

로그

서버 로그를 담는 데이터 블록입니다.

컬럼으로 구성된 데이터 블록으로 인코딩되지만, 압축되지는 않습니다.

컬럼타입
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