> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# merge_max_* MergeTree 테이블 설정

> merge_max_* 생성 그룹에 속한 ClickHouse MergeTree 테이블 설정입니다.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이 설정은 [system.merge\_tree\_settings](/docs/ko/reference/system-tables/merge_tree_settings)에서 확인할 수 있으며, ClickHouse 소스에서 자동 생성됩니다.

<div id="merge_max_block_size">
  ## merge\_max\_block\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="8192" />

병합된 파트에서 메모리로 읽어 오는 행 수입니다.

가능한 값:

* 임의의 양의 정수.

머지 작업은 파트에서 `merge_max_block_size`행 단위의 블록으로 행을 읽은 다음,
이를 병합하여 결과를 새 파트에 기록합니다. 읽기 블록은 RAM에 올라가므로,
`merge_max_block_size`는 머지에 필요한 RAM 크기에 영향을 줍니다.
따라서 행 크기가 매우 큰 테이블에서는 머지 시 많은 양의 RAM을 사용할 수 있습니다
(평균 행 크기가 100kb인 경우, 10개의 파트를 머지하면
(100kb \* 10 \* 8192) = 약 8GB의 RAM). `merge_max_block_size`를 줄이면
머지에 필요한 RAM 사용량은 줄일 수 있지만 머지 속도는 느려집니다.

<div id="merge_max_block_size_bytes">
  ## merge\_max\_block\_size\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="10485760" />

머지 작업에서 형성할 블록의 바이트 수입니다. 기본적으로
`index_granularity_bytes`와 같은 값입니다.

<div id="merge_max_bytes_to_prewarm_cache">
  ## merge\_max\_bytes\_to\_prewarm\_cache
</div>

<SettingsInfoBlock type="UInt64" default_value="1073741824" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1073741824"},{"label": "Cloud sync"}]}]} />

ClickHouse Cloud에서만 사용할 수 있습니다. 머지 중 캐시를 예열할 파트(compact 또는 패킹)의 최대 크기입니다.

<div id="merge_max_dynamic_subcolumns_in_compact_part">
  ## merge\_max\_dynamic\_subcolumns\_in\_compact\_part
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "auto"},{"label": "데이터 타입에 지정된 매개변수와 관계없이 머지 후 Compact 데이터 파트의 동적 서브컬럼 수를 제한하는 새로운 설정을 추가했습니다"}]}]} />

머지 후 각 컬럼의 Compact 데이터 파트에 생성할 수 있는 동적 서브컬럼의 최대 개수입니다.
이 설정을 사용하면 데이터 타입에 지정된 동적 매개변수와 관계없이 Compact 데이터 파트의 동적 서브컬럼 수를 제어할 수 있습니다.

예를 들어, 테이블에 `JSON(max_dynamic_paths=1024)` 타입의 컬럼이 있고 `merge_max_dynamic_subcolumns_in_compact_part` 설정이 128로 되어 있으면,
Compact 데이터 파트로 머지된 후 이 파트의 동적 경로 수는 128로 줄어들고 128개의 경로만 동적 서브컬럼으로 기록됩니다.

<div id="merge_max_dynamic_subcolumns_in_wide_part">
  ## merge\_max\_dynamic\_subcolumns\_in\_wide\_part
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "auto"},{"label": "데이터 타입에 지정된 매개변수와 관계없이 머지 후 파트의 동적 서브컬럼 수를 제한하는 새로운 설정 추가"}]}]} />

머지 후 각 컬럼의 Wide 데이터 파트에서 생성할 수 있는 동적 서브컬럼의 최대 개수입니다.
데이터 타입에 지정된 동적 매개변수와 관계없이 Wide 데이터 파트에서 생성되는 파일 수를 줄일 수 있습니다.

예를 들어, 테이블에 JSON(max\_dynamic\_paths=1024) 타입의 컬럼이 있고 설정 merge\_max\_dynamic\_subcolumns\_in\_wide\_part가 128로 설정된 경우,
Wide 데이터 파트로 머지된 후 이 파트의 동적 경로 수는 128개로 줄어들며, 128개의 경로만 동적 서브컬럼으로 기록됩니다.