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

# number_of_* MergeTree 테이블 설정

> number_of_* 그룹에 속하는 ClickHouse MergeTree 테이블 설정입니다.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["버전", "기본값", "설명"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        버전 이력
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

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](/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](/ko/reference/settings/server-settings/settings#background_pool_size) 값보다 작아야 합니다.

* [background\_merges\_mutations\_concurrency\_ratio](/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](/ko/reference/settings/server-settings/settings#background_pool_size)

* [background\_merges\_mutations\_concurrency\_ratio](/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" />

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