네이티브 클라이언트 패킷

값	이름	설명
0	Hello	클라이언트 핸드셰이크 시작
1	Query	쿼리 요청
2	데이터	데이터 블록
3	Cancel	쿼리 취소
4	Ping	Ping 요청
5	TableStatus	테이블 상태 요청

Data 패킷은 압축할 수 있습니다.

Hello

예를 들어, 54451 프로토콜 버전을 지원하는 Go Client v1.10을 사용해 default 데이터베이스에 default 사용자와 secret 비밀번호로 연결하려고 한다고 가정합니다.

필드	유형	값	설명
client_name	String	`"Go Client"`	클라이언트 구현 이름
version_major	UVarInt	`1`	클라이언트 메이저 버전
version_minor	UVarInt	`10`	클라이언트 마이너 버전
protocol_version	UVarInt	`54451`	TCP 프로토콜 버전
database	String	`"default"`	데이터베이스 이름
username	String	`"default"`	사용자 이름
password	String	`"secret"`	비밀번호

프로토콜 버전

프로토콜 버전은 클라이언트가 사용하는 TCP 프로토콜 버전입니다. 일반적으로 최신 호환 서버 리비전과 같지만, 이와 혼동해서는 안 됩니다.

기본값

모든 값은 명시적으로 설정해야 하며, 서버 측에는 기본값이 없습니다. 클라이언트 측의 기본값은 "default" 데이터베이스(database), "default" 사용자 이름, 그리고 "" (빈 문자열) 비밀번호입니다.

쿼리

field	유형	값	설명
query_id	String	`1ff-a123`	쿼리 ID, UUIDv4일 수 있습니다
client_info	ClientInfo	유형 참조	클라이언트 정보
settings	설정	유형 참조	설정 목록
secret	String	`secret`	서버 간 공유 비밀
stage	UVarInt	`2`	쿼리 단계까지 실행
compression	UVarInt	`0`	비활성화=0, 활성화=1
body	String	`SELECT 1`	쿼리 텍스트

클라이언트 정보

필드	유형	설명
query_kind	byte	None=0, Initial=1, Secondary=2
initial_user	String	초기 사용자
initial_query_id	String	초기 쿼리 ID
initial_address	String	초기 주소
initial_time	Int64	초기 시간
interface	byte	TCP=1, HTTP=2
os_user	String	OS 사용자
client_hostname	String	클라이언트 호스트명
client_name	String	클라이언트 이름
version_major	UVarInt	클라이언트 메이저 버전
version_minor	UVarInt	클라이언트 마이너 버전
protocol_version	UVarInt	클라이언트 프로토콜 버전
quota_key	String	QUOTA 키
distributed_depth	UVarInt	분산 깊이
version_patch	UVarInt	클라이언트 패치 버전
otel	Bool	트레이스 필드 포함
trace_id	FixedString(16)	트레이스 ID
span_id	FixedString(8)	스팬 ID
trace_state	String	트레이싱 상태
trace_flags	Byte	트레이싱 플래그

설정

필드	유형	값	설명
key	String	`send_logs_level`	설정의 키
value	String	`trace`	설정의 값
important	Bool	`true`	무시 가능 여부

목록 형태로 인코딩되며, key와 value가 비어 있으면 목록의 끝을 나타냅니다.

단계

값	이름	설명
0	FetchColumns	컬럼 타입만 가져옵니다
1	WithMergeableState	머지 가능한 상태까지
2	Complete	완전한 상태까지(기본값이어야 합니다)

데이터

필드	유형	설명
info	BlockInfo	인코딩된 블록 정보
columns	UVarInt	컬럼 수
rows	UVarInt	행 수
columns	[]컬럼	데이터를 포함하는 컬럼

컬럼

필드	유형	값	설명
name	String	`foo`	컬럼 이름
type	String	`DateTime64(9)`	컬럼 유형
data	bytes	~	컬럼 데이터

Cancel

패킷 본문은 없습니다. 서버는 쿼리를 취소해야 합니다.

Ping

패킷 본문은 없습니다. 서버는 pong으로 응답해야 합니다.

소개

빌드

네이티브 프로토콜

기여하기

로드맵

Hello

프로토콜 버전

기본값

쿼리

클라이언트 정보

설정

단계

데이터

컬럼

Cancel

Ping

​Hello

​프로토콜 버전

​기본값

​쿼리

​클라이언트 정보

​설정

​단계

​데이터

​컬럼

​Cancel

​Ping

Hello

프로토콜 버전

기본값

쿼리

클라이언트 정보

설정

단계

데이터

컬럼

Cancel

Ping