メインコンテンツへスキップ
ClickHouseプロトコルは、チェックサム付きのデータブロック圧縮をサポートしています。 どのモードを選べばよいかわからない場合は、LZ4 を使用してください。 “
利用可能なカラム圧縮コーデックの詳細を確認し、テーブルの作成時または作成後に指定してください。

モード

valuenamedescription
0x02None圧縮なし、チェックサムのみ
0x82LZ4非常に高速で、圧縮率も良好
0x90ZSTDZstandard、かなり高速で、圧縮率は最高
LZ4 と ZSTD はどちらも同じ著者によるものですが、トレードオフが異なります。 Facebook benchmarks より:
nameratioencodingdecoding
zstd 1.4.5 -12.8500 MB/s1660 MB/s
lz4 1.9.22.1740 MB/s4530 MB/s

ブロック

フィールド説明
checksumuint128(header + compressed data) の ハッシュ
raw_sizeuint32ヘッダーを除いた元のサイズ
data_sizeuint32非圧縮データサイズ
modebyte圧縮モード
compressed_databinary圧縮データのブロック
ヘッダーは (raw_size + data_size + mode) で、raw size は len(header + compressed_data) に相当します。 Checksum は ClickHouse CityHash を使用した hash(header + compressed_data) です。

None モード

None モードを使用すると、compressed_data は元のデータと同じです。 圧縮しないモードは、ハッシュ計算のオーバーヘッドがごく小さいため、チェックサムによる追加のデータ整合性の確保に役立ちます。
最終更新日 2026年6月10日