> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 압축 모드

> ClickHouse 컬럼 압축 모드

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

ClickHouse 프로토콜은 체크섬과 함께 **데이터 블록** 압축을 지원합니다.
어떤 모드를 선택할지 확실하지 않다면 `LZ4`를 사용하세요.
\`\`

<Tip>
  사용할 수 있는 [컬럼 압축 코덱](/ko/reference/statements/create/table#column_compression_codec)을 자세히 알아보고, 테이블을 생성할 때 또는 생성한 후에 지정하세요.
</Tip>

<div id="modes">
  ## 모드
</div>

| value  | name               | description                   |
| ------ | ------------------ | ----------------------------- |
| `0x02` | [None](#none-mode) | 압축 없음, 체크섬만 사용                |
| `0x82` | LZ4                | 매우 빠르고 압축률도 우수함               |
| `0x90` | ZSTD               | Zstandard, 상당히 빠르며 압축률이 가장 높음 |

LZ4와 ZSTD는 모두 같은 작성자가 만들었지만, 설계상 절충점은 서로 다릅니다.
[Facebook 벤치마크](https://facebook.github.io/zstd/#benchmarks)에 따르면:

| name              | ratio | encoding | decoding  |
| ----------------- | ----- | -------- | --------- |
| **zstd** 1.4.5 -1 | 2.8   | 500 MB/s | 1660 MB/s |
| **lz4** 1.9.2     | 2.1   | 740 MB/s | 4530 MB/s |

<div id="block">
  ## 블록
</div>

| 필드               | 유형      | 설명                                                                         |
| ---------------- | ------- | -------------------------------------------------------------------------- |
| checksum         | uint128 | (헤더 + 압축 데이터)의 [해시](/ko/resources/develop-contribute/native-protocol/hash) |
| raw\_size        | uint32  | 헤더를 제외한 원본 크기                                                              |
| data\_size       | uint32  | 비압축 데이터 크기                                                                 |
| mode             | byte    | 압축 모드                                                                      |
| compressed\_data | binary  | 압축된 데이터 블록                                                                 |

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/k6dUBbEUOmZKxz3v/images/data-compression/ch_compression_block.png?fit=max&auto=format&n=k6dUBbEUOmZKxz3v&q=85&s=989a3dcf0cc61ef83569ead6c7845b3b" size="md" alt="ClickHouse 압축 블록 구조를 보여주는 다이어그램" width="2048" height="602" data-path="images/data-compression/ch_compression_block.png" />

헤더는 (raw\_size + data\_size + mode)로 구성되며, raw size는 len(header + compressed\_data)입니다.

체크섬은 [ClickHouse CityHash](/ko/resources/develop-contribute/native-protocol/hash)를 사용해 계산한 `hash(header + compressed_data)`입니다.

<div id="none-mode">
  ## None 모드
</div>

*None* 모드를 사용하면 `compressed_data`는 원본 데이터와 동일합니다.
압축하지 않는 모드는 체크섬을 통해 추가적인 데이터 무결성을 보장하는 데 유용합니다. hash 계산 오버헤드는 무시할 수 있을 만큼 작기 때문입니다.