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" | 비밀번호 |
프로토콜 버전
기본값
"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 | 무시 가능 여부 |
단계
| 값 | 이름 | 설명 |
|---|---|---|
| 0 | FetchColumns | 컬럼 타입만 가져옵니다 |
| 1 | WithMergeableState | 머지 가능한 상태까지 |
| 2 | Complete | 완전한 상태까지(기본값이어야 합니다) |
데이터
| 필드 | 유형 | 설명 |
|---|---|---|
| info | BlockInfo | 인코딩된 블록 정보 |
| columns | UVarInt | 컬럼 수 |
| rows | UVarInt | 행 수 |
| columns | []컬럼 | 데이터를 포함하는 컬럼 |
컬럼
| 필드 | 유형 | 값 | 설명 |
|---|---|---|---|
| name | String | foo | 컬럼 이름 |
| type | String | DateTime64(9) | 컬럼 유형 |
| data | bytes | ~ | 컬럼 데이터 |