메인 콘텐츠로 건너뛰기
이름설명
0Hello서버 핸드셰이크 응답
1데이터client data와 동일
2예외쿼리 처리 예외
3Progress쿼리 진행 상황
4PongPing 응답
5EndOfStream모든 패킷 전송 완료
6ProfileInfo프로파일링 데이터
7합계합계 값
8극값극값 (min, max)
9TablesStatusResponseTableStatus 요청에 대한 응답
10Log쿼리 시스템 로그
11TableColumns컬럼 설명
12UUIDs고유한 파트 ID 목록
13ReadTaskRequest다음 작업이 필요한 요청을 나타내는 String(UUID)
14ProfileEvents서버의 프로파일 이벤트가 포함된 패킷
Data, TotalsExtremes는 압축할 수 있습니다.

Hello

client Hello에 대한 응답입니다.
field유형설명
nameStringClickhouse서버 이름
version_majorUVarInt21서버 메이저 버전
version_minorUVarInt12서버 마이너 버전
revisionUVarInt54452서버 리비전
tzStringEurope/Moscow서버 시간대
display_nameStringClickhouseUI에 표시되는 서버 이름
version_patchUVarInt3서버 패치 버전

예외

쿼리 처리 중 서버 예외가 발생합니다.
fieldtypevaluedescription
codeInt3260ErrorCodes.cpp를 참조하십시오.
nameStringDB::Exception서버 메이저 버전
messageStringDB::Exception: Table X doesn't exist서버 마이너 버전
stack_traceString~C++ 스택 트레이스
nestedBooltrue추가 오류
nestedfalse가 될 때까지 예외가 연속된 목록으로 이어질 수 있습니다.

Progress

서버가 주기적으로 보고하는 쿼리 실행 진행 상황입니다.
진행 상황은 증분값(deltas) 으로 보고됩니다. 합계는 클라이언트에서 누적하십시오.
field유형valuedescription
rowsUVarInt65535행 수
bytesUVarInt871799바이트 수
total_rowsUVarInt0총 행 수
wrote_rowsUVarInt0클라이언트에서 전송한 행 수
wrote_bytesUVarInt0클라이언트에서 전송한 바이트 수

Pong

클라이언트 Ping에 대한 응답으로, 패킷 본문은 없습니다.

스트림 종료

더 이상 데이터 패킷은 전송되지 않으며, 쿼리 결과의 스트리밍이 서버에서 클라이언트로 모두 완료되었습니다. 패킷 본문은 없습니다.

프로필 정보

필드유형
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

프로파일 이벤트

프로파일 이벤트가 포함된 **데이터 블록(data block)**입니다.
컬럼으로 이루어진 **데이터 블록(data block)**으로 인코딩되지만, 압축되지는 않습니다.value의 유형은 서버 리비전에 따라 UInt64 또는 Int64입니다.
컬럼유형
host_nameString
current_timeDateTime
thread_idUInt64
typeInt8
nameString
valueUInt64 or Int64
마지막 수정일 2026년 6월 10일