> ## 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.

# max_* MergeTree 테이블 설정

> 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="max_avg_part_size_for_too_many_parts">
  ## max\_avg\_part\_size\_for\_too\_many\_parts
</div>

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

'parts\_to\_delay\_insert' 및
'parts\_to\_throw\_insert'에 따른 'too many parts' 검사는 해당
파티션의 평균 파트 크기가 지정된 임계값보다 크지 않은 경우에만 활성화됩니다. 평균
파트 크기가 지정된 임계값보다 크면 INSERT는 지연되거나 거부되지
않습니다. 따라서 파트가 더 큰 파트로 성공적으로 머지되면 단일
서버의 단일 테이블에 수백 테라바이트의 데이터를 저장할 수 있습니다. 이는
비활성 파트 또는 전체 파트의 임계값에는 영향을 주지 않습니다.

<div id="max_buckets_in_map">
  ## max\_buckets\_in\_map
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "32"},{"label": "'with_buckets' Map serialization의 최대 버킷 수를 제어하는 설정이 추가되었습니다"}]}]} />

`Map` serialization의 최대 버킷 수입니다. `with_buckets` `Map` serialization에서 사용됩니다.
실제 버킷 수는 [map\_buckets\_strategy](/docs/ko/reference/settings/merge-tree-settings/map-buckets#map_buckets_strategy)에 따라 결정됩니다.
허용되는 최대값은 256입니다.

<div id="max_cleanup_delay_period">
  ## max\_cleanup\_delay\_period
</div>

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

오래된 큐 로그, 블록 해시 및 파트를 정리하는 최대 주기입니다.

<div id="max_compress_block_size">
  ## max\_compress\_block\_size
</div>

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

테이블에 쓰기 위해 압축하기 전에, 압축되지 않은 데이터 블록의 최대
크기입니다. 이 설정은 전역 설정에서도 지정할 수 있습니다
([max\_compress\_block\_size](/docs/ko/reference/settings/merge-tree-settings/max#max_compress_block_size)
설정 참조). 테이블 생성 시 지정한 값은 이 설정의 전역
값을 재정의합니다.

<div id="max_concurrent_queries">
  ## max\_concurrent\_queries
</div>

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

MergeTree 테이블과 관련된 쿼리를 동시에 실행할 수 있는 최대 개수입니다.
쿼리는 다른 `max_concurrent_queries` 설정의 적용도 받습니다.

Possible values:

* 양의 정수.
* `0` — 제한 없음.

기본값: `0` (제한 없음).

**예시**

```xml theme={null}
<max_concurrent_queries>50</max_concurrent_queries>
```

<div id="max_digestion_size_per_segment">
  ## max\_digestion\_size\_per\_segment
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "268435456"},{"label": "더 이상 사용되지 않는 설정"}]}]} />

더 이상 사용되지 않는 설정이며, 아무런 효과가 없습니다.

<div id="max_file_name_length">
  ## max\_file\_name\_length
</div>

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

해싱하지 않고 파일 이름을 그대로 유지할 수 있는 최대 길이입니다.
이 설정은 `replace_long_file_name_to_hash` 설정이 활성화된 경우에만 적용됩니다.
이 설정값에는 파일 확장자의 길이가 포함되지 않습니다. 따라서
파일 시스템 오류를 방지할 수 있도록 여유를 두고 최대 파일 이름 길이(보통 255
바이트)보다 작게 설정하는 것이 좋습니다.

<div id="max_partitions_to_read">
  ## max\_partitions\_to\_read
</div>

<SettingsInfoBlock type="Int64" default_value="-1" />

하나의 쿼리에서 액세스할 수 있는 파티션의 최대 개수를 제한합니다.

table을 생성할 때 지정한 설정 값은
쿼리 수준 설정으로 재정의할 수 있습니다.

가능한 값:

* 모든 양의 정수

쿼리 / 세션 / profile 수준에서 쿼리 복잡도 설정 [max\_partitions\_to\_read](/docs/ko/reference/settings/session-settings#max_partitions_to_read)를
지정할 수도 있습니다.

<div id="max_projections">
  ## max\_projections
</div>

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

MergeTree 프로젝션의 최대 개수입니다.

<div id="max_uncompressed_bytes_in_patches">
  ## max\_uncompressed\_bytes\_in\_patches
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "32212254720"},{"label": "새로운 설정"}]}]} />

모든 패치 파트에 있는 데이터의 최대 압축되지 않은 크기(바이트)입니다.
모든 패치 파트의 데이터 양이 이 값을 초과하면 경량 업데이트가 거부됩니다.
0 - 무제한.