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

# allow_* MergeTree 테이블 설정

> allow_* 그룹에 속한 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>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            실험 기능입니다. <u><a href="/docs/docs/beta-and-experimental-features#experimental-features">자세히 알아보세요.</a></u>
        </div>;
};

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

<div id="allow_coalescing_columns_in_partition_or_order_key">
  ## allow\_coalescing\_columns\_in\_partition\_or\_order\_key
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "0"},{"label": "파티션 또는 정렬 키 컬럼에 coalescing을 허용하는 새로운 설정입니다."}]}]} />

활성화하면 CoalescingMergeTree 테이블에서 coalescing 컬럼을
파티션 또는 정렬 키로 사용할 수 있습니다.

<div id="allow_commit_order_projection">
  ## allow\_commit\_order\_projection
</div>

<ExperimentalBadge />

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

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

`_block_number` 및 `_block_offset` 가상 컬럼을 저장하는 커밋 순서 프로젝션을 활성화하며, 머지 중에도 원래의 삽입 순서를 유지합니다.
이 기능을 사용하려면 `enable_block_number_column` 및 `enable_block_offset_column`이 활성화되어 있어야 합니다.

<div id="allow_dimensions_outside_sorting_key">
  ## allow\_dimensions\_outside\_sorting\_key
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "이제 AggregatingMergeTree는 테이블 생성 시 컬럼이 정렬 키에 속하지도 않고 집계 상태 측정값도 아닌 스키마를 거부합니다. 이전에는 이러한 스키마가 허용되었으며(이전 동작은 값 'true'에 해당함)"}]}]} />

`AggregatingMergeTree`에서는 백그라운드 머지가 정렬 키(sorting key)의 동일한 값을 공유하는 행들을 하나로 합치고, 해당 집계 상태(aggregate state)를 결합합니다. 정렬 키에 속하지도 않고 집계 상태 *측정값*(`AggregateFunction` 또는 `SimpleAggregateFunction`)도 아닌 컬럼은 *차원*입니다. 이러한 컬럼은 머지 후 합쳐진 행 중 하나의 임의 값을 유지하므로, 이를 기준으로 `GROUP BY`를 수행하거나 필터링하는 쿼리에서 잘못된 결과가 조용히 발생할 수 있습니다(참조:
[https://github.com/ClickHouse/ClickHouse/issues/751](https://github.com/ClickHouse/ClickHouse/issues/751)).

기본적으로 이러한 스키마는 테이블 생성 시 거부됩니다. 컬럼이 정렬 키에 함수적으로 종속되어 있어(즉, 합쳐지는 모든 행이 동일한 값을 가짐) 이러한 동작이 의도된 경우에만 이 설정을 활성화하세요.

이 검사는 실제로 집계를 수행하는 테이블(즉, 집계 상태 컬럼이 하나 이상 있는 테이블)에만 적용되며, `allow_tuple_element_aggregation`이 활성화된 경우에는 건너뜁니다.

<div id="allow_floating_point_partition_key">
  ## allow\_floating\_point\_partition\_key
</div>

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

부동소수점 수를 파티션 키로 사용할 수 있도록 허용합니다.

가능한 값:

* `0` — 부동소수점 파티션 키는 허용되지 않습니다.
* `1` — 부동소수점 파티션 키가 허용됩니다.

<div id="allow_minmax_index_for_json">
  ## allow\_minmax\_index\_for\_json
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "인덱스 serialization이 JSON 컬럼에 포함될 수 있는 이질적인 Field 값을 처리할 수 없으므로, 기본적으로 JSON 컬럼에 minmax 스킵 인덱스를 생성할 수 없도록 합니다"}]}]} />

JSON (Object) 컬럼에 minmax 스킵 인덱스를 생성할 수 있도록 허용합니다. 기본적으로는 비활성화되어 있습니다. 이는 minmax
인덱스 serialization 경로가 JSON 컬럼에 포함될 수 있는 이질적인 Field 값을 처리할 수 없기 때문입니다.

<div id="allow_nullable_key">
  ## allow\_nullable\_key
</div>

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

널 허용 타입을 기본 키(primary key)로 사용할 수 있습니다.

<div id="allow_part_offset_column_in_projections">
  ## allow\_part\_offset\_column\_in\_projections
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1"},{"label": "이제 프로젝션에서 _part_offset 컬럼을 사용할 수 있습니다."}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "0"},{"label": "새로운 설정으로, 안정화되기 전까지는 부모 part offset 컬럼을 사용하는 프로젝션이 생성되지 않도록 합니다."}]}]} />

프로젝션의 SELECT 쿼리에서 '\_part\_offset' 컬럼 사용을 허용합니다.

<div id="allow_reduce_blocking_parts_task">
  ## allow\_reduce\_blocking\_parts\_task
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "1"},{"label": "이제 SMT는 기본적으로 ZooKeeper에서 오래된 차단 파트를 제거합니다"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "0"},{"label": "Cloud sync"}]}]} />

shared merge tree 테이블의 차단 파트를 줄이는 백그라운드 작업입니다.
ClickHouse Cloud에서만 사용할 수 있습니다

<div id="allow_remote_fs_zero_copy_replication">
  ## allow\_remote\_fs\_zero\_copy\_replication
</div>

<ExperimentalBadge />

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

아직 사용할 준비가 되지 않았으므로 이 설정은 운영 환경에서 사용하지 마십시오.

<div id="allow_summing_columns_in_partition_or_order_key">
  ## allow\_summing\_columns\_in\_partition\_or\_order\_key
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.4"},{"label": "0"},{"label": "합산 컬럼을 파티션 또는 정렬 키에 사용할 수 있도록 하는 새로운 설정"}]}]} />

활성화하면 SummingMergeTree 테이블의 합산 컬럼을
파티션 또는 정렬 키에 사용할 수 있습니다.

<div id="allow_suspicious_indices">
  ## allow\_suspicious\_indices
</div>

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

동일한 표현식을 사용하는 프라이머리/세컨더리 인덱스와 정렬 키를 거부합니다

<div id="allow_tuple_element_aggregation">
  ## allow\_tuple\_element\_aggregation
</div>

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

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

활성화하면 Tuple 컬럼 내부의 개별 원소가 SummingMergeTree, AggregatingMergeTree 및
CoalescingMergeTree에서 머지 시 집계 대상에 포함됩니다. 중첩된 Tuple은 재귀적으로 확장되므로 모든
리프 원소가 각각 독립적으로 집계됩니다. 이 설정은 변경할 수 없으며
테이블 생성 시에 지정해야 합니다.

<div id="allow_vertical_merges_from_compact_to_wide_parts">
  ## allow\_vertical\_merges\_from\_compact\_to\_wide\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

compact 형식에서 wide 형식의 파트로 수행되는 수직 병합을 허용합니다. 이 설정은 모든 레플리카에서
동일한 값이어야 합니다.
