基本

注記

クライアントプロトコルのリファレンスは進行中です。

ほとんどの例はGoのみです。

このドキュメントは、ClickHouse TCPクライアントのバイナリプロトコルを説明します。

Varint

長さ、パケットコード、および他のケースでは unsigned varint エンコーディングが使用されます。 使用するには、binary.PutUvarint および binary.ReadUvarint。

注記

Signed varintは使用されません。

文字列

可変長の文字列は (長さ、値) としてエンコードされます。ここで、長さ は varint で、値 はutf8文字列です。

参考

OOMを防ぐために長さを検証してください：

0 ≤ len < MAX

エンコード

s := "Hello, world!"

// 文字列の長さをuvarintとして書き込みます。
buf := make([]byte, binary.MaxVarintLen64)
n := binary.PutUvarint(buf, uint64(len(s)))
buf = buf[:n]

// 文字列の値を書き込みます。
buf = append(buf, s...)

デコード

r := bytes.NewReader([]byte{
    0xd, 0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x2c,
    0x20, 0x77, 0x6f, 0x72, 0x6c, 0x64, 0x21,
})

// 長さを読み取ります。
n, err := binary.ReadUvarint(r)
if err != nil {
        panic(err)
}

// OOMやmake()の実行時例外を防ぐためにnをチェックします。
const maxSize = 1024 * 1024 * 10 // 10 MB
if n > maxSize || n < 0 {
    panic("無効なn")
}

buf := make([]byte, n)
if _, err := io.ReadFull(r, buf); err != nil {
        panic(err)
}

fmt.Println(string(buf))
// Hello, world!

16進ダンプ

00000000  0d 48 65 6c 6c 6f 2c 20  77 6f 72 6c 64 21        |.Hello, world!|

Base64

DUhlbGxvLCB3b3JsZCE

Go

data := []byte{
    0xd, 0x48, 0x65, 0x6c, 0x6c, 0x6f, 0x2c,
    0x20, 0x77, 0x6f, 0x72, 0x6c, 0x64, 0x21,
}

整数

ヒント

ClickHouseは固定サイズ整数に リトルエンディアン を使用します。

Int32

v := int32(1000)

// エンコード。
buf := make([]byte, 8)
binary.LittleEndian.PutUint32(buf, uint32(v))

// デコード。
d := int32(binary.LittleEndian.Uint32(buf))
fmt.Println(d) // 1000

16進ダンプ

00000000  e8 03 00 00 00 00 00 00                           |........|

Base64

6AMAAAAAAAA

ブーリアン

ブーリアン値は1バイトで表現され、1 は true、0 は false です。