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

# number_of_* MergeTree 테이블 설정

> number_of_* 그룹에 속하는 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="number_of_free_entries_in_pool_to_execute_mutation">
  ## number\_of\_free\_entries\_in\_pool\_to\_execute\_mutation
</div>

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

풀의 가용 엔트리 수가 지정한 값보다 적으면
파트 뮤테이션을 실행하지 않습니다. 이는 일반적인 머지에 사용할 여유 스레드를 남겨 두고
「Too many parts」 오류를 방지하기 위한 것입니다.

가능한 값:

* 모든 양의 정수.

**사용**

`number_of_free_entries_in_pool_to_execute_mutation` 설정 값은
[background\_pool\_size](/docs/ko/reference/settings/server-settings/settings#background_pool_size) 값보다 작아야 합니다.

* [background\_merges\_mutations\_concurrency\_ratio](/docs/ko/reference/settings/server-settings/settings#background_merges_mutations_concurrency_ratio).
  그렇지 않으면 ClickHouse가 예외를 발생시킵니다.

<div id="number_of_free_entries_in_pool_to_execute_optimize_entire_partition">
  ## number\_of\_free\_entries\_in\_pool\_to\_execute\_optimize\_entire\_partition
</div>

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

풀에서 사용 가능한 엔트리 수가 지정된 수보다 적으면,
백그라운드에서 파티션 전체 최적화를 실행하지 않습니다(이 작업은
`min_age_to_force_merge_seconds`를 설정하고
`min_age_to_force_merge_on_partition_only`를 활성화하면 생성됩니다). 이는
일반적인 머지를 위한 여유 스레드를 남겨 두어 "Too many parts"를 방지하기 위한 것입니다.

가능한 값:

* 양의 정수.

`number_of_free_entries_in_pool_to_execute_optimize_entire_partition`
설정 값은 다음 값보다 작아야 합니다.
[background\_pool\_size](/docs/ko/reference/settings/server-settings/settings#background_pool_size)

* [background\_merges\_mutations\_concurrency\_ratio](/docs/ko/reference/settings/server-settings/settings#background_merges_mutations_concurrency_ratio).
  그렇지 않으면 ClickHouse에서 예외가 발생합니다.

<div id="number_of_free_entries_in_pool_to_lower_max_size_of_merge">
  ## number\_of\_free\_entries\_in\_pool\_to\_lower\_max\_size\_of\_merge
</div>

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

풀(또는 복제된 큐)의 사용 가능한 엔트리 수가 지정된 값보다 적어지면,
처리할(또는 큐에 넣을) 머지의 최대 크기를 낮추기 시작합니다.
이 설정은 오래 실행되는 머지로 풀이 가득 차지 않도록 하여,
작은 머지를 처리할 수 있게 하기 위한 것입니다.

가능한 값:

* 임의의 양의 정수.

<div id="number_of_mutations_to_delay">
  ## number\_of\_mutations\_to\_delay
</div>

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

테이블에 완료되지 않은 뮤테이션이
해당 개수 이상 있으면 테이블의 뮤테이션 속도를 인위적으로 늦춥니다.
0으로 설정하면 비활성화됩니다.

<div id="number_of_mutations_to_throw">
  ## number\_of\_mutations\_to\_throw
</div>

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

테이블에 완료되지 않은 뮤테이션이 이 수 이상 있으면 'Too many mutations' 예외를 발생시킵니다.
0으로 설정하면 비활성화됩니다

<div id="number_of_partitions_to_consider_for_merge">
  ## number\_of\_partitions\_to\_consider\_for\_merge
</div>

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

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

ClickHouse Cloud에서만 사용할 수 있습니다. 머지를 위해 고려할 상위 N개의
파티션 수입니다. 파티션은 해당 파티션에서 머지할 수 있는 데이터 파트의 수를
가중치로 하여 무작위로 선택됩니다.