Pular para o conteúdo principal
O protocolo do ClickHouse oferece suporte à compressão de blocos de dados com checksum. Use LZ4 se não tiver certeza de qual modo escolher. “
Saiba mais sobre os codecs de compressão de colunas disponíveis e especifique-os ao criar suas tabelas ou posteriormente.

Modos

valornomedescrição
0x02NoneSem compressão, apenas checksums
0x82LZ4Extremamente rápido, boa compressão
0x90ZSTDZstandard, bastante rápido, melhor compressão
Tanto o LZ4 quanto o ZSTD foram criados pelo mesmo autor, mas com trade-offs diferentes. Segundo benchmarks do Facebook:
nometaxacodificaçãodecodificação
zstd 1.4.5 -12.8500 MB/s1660 MB/s
lz4 1.9.22.1740 MB/s4530 MB/s

Bloco

campotipodescrição
checksumuint128Hash de (cabeçalho + dados compactados)
raw_sizeuint32Tamanho bruto sem o cabeçalho
data_sizeuint32Tamanho dos dados descompactados
modebyteModo de compressão
compressed_databinaryBloco de dados compactados
O cabeçalho é (raw_size + data_size + mode), e o tamanho bruto corresponde a len(header + compressed_data). O checksum é hash(header + compressed_data), usando ClickHouse CityHash.

Modo None

Se o modo None for usado, compressed_data será igual aos dados originais. O modo sem compressão é útil para garantir uma camada adicional de integridade dos dados com checksums, porque a sobrecarga do cálculo de hash é desprezível.
Última modificação em 10 de junho de 2026