allow_* MergeTree 설정
allow_* MergeTree 설정 (allow_* MergeTree settings)
이 문서는 allow_*로 시작하는 MergeTree 설정들을 다루는 페이지예요. 특정 유형의 열을 키에 사용하거나, 특정 병합·프로젝션·인덱스 동작을 허용하는 설정들이 자동 생성되어 정리되어 있어요.
출처: 문서
본문
이 설정들은 system.merge_tree_settings에서 확인할 수 있으며 ClickHouse 소스에서 자동 생성됩니다.
allow_coalescing_columns_in_partition_or_order_key
활성화하면 CoalescingMergeTree 테이블의 coalescing 열을 파티션 또는 정렬 키에 사용할 수 있게 해줘요.
allow_commit_order_projection
_block_number와 _block_offset 가상 열을 저장해 병합을 거쳐도 원래 삽입 순서를 유지하는 커밋 순서 프로젝션을 활성화해요. enable_block_number_column과 enable_block_offset_column이 활성화되어 있어야 합니다.
allow_dimensions_outside_sorting_key
AggregatingMergeTree에서 백그라운드 병합은 정렬 키의 같은 값을 공유하는 행을 접어서 집계 상태를 결합해요. 정렬 키의 일부도 아니고 집계 상태 측정값도 아닌 열은 *차원(dimension)*이 됩니다. 병합 후에는 접힌 행 중 하나의 임의 값을 유지하므로, 그 열에 대해 GROUP BY하거나 필터링하는 쿼리에서 조용히 잘못된 결과가 발생합니다(https://github.com/ClickHouse/ClickHouse/issues/751 참고). 기본적으로 테이블 생성 시 이런 스키마는 거부됩니다. 열이 정렬 키에 함수적으로 의존하여(접힌 모든 행이 같은 값을 공유함) 그 동작이 의도적이라면 이 설정을 활성화하세요. 이 검사는 실제로 집계하는 테이블(집계 상태 열이 하나 이상 있는 테이블)에만 적용되며, allow_tuple_element_aggregation이 활성화되면 건너뜁니다.
allow_floating_point_partition_key
부동소수점 숫자를 파티션 키로 허용할지 여부를 설정해요. 가능한 값:
- 0 — 부동소수점 파티션 키가 허용되지 않음.
- 1 — 부동소수점 파티션 키가 허용됨.
allow_minmax_index_for_json
JSON (Object) 열에 minmax 스킵 인덱스를 만들 수 있게 허용할지 여부예요. minmax 인덱스 직렬화 경로가 JSON 열이 포함할 수 있는 이질적인 Field 값을 처리할 수 없기 때문에 기본적으로 비활성화됩니다.
allow_nullable_key
Nullable 타입을 기본 키로 허용할지 여부예요.
allow_part_offset_column_in_projections
프로젝션 select 쿼리에서 ‘_part_offset’ 열 사용을 허용할지 여부예요.
allow_reduce_blocking_parts_task
공유 머지 트리 테이블의 차단 파트를 줄이는 백그라운드 작업이에요. ClickHouse Cloud에서만 사용됩니다.
allow_remote_fs_zero_copy_replication
이 설정은 아직 준비되지 않았으므로 프로덕션에서 사용하지 마세요.
allow_summing_columns_in_partition_or_order_key
활성화하면 SummingMergeTree 테이블의 summing 열을 파티션 또는 정렬 키에 사용할 수 있게 해줘요.
allow_suspicious_indices
동일한 표현식을 가진 기본/보조 인덱스와 정렬 키를 거부할지 여부예요.
allow_tuple_element_aggregation
활성화하면 SummingMergeTree, AggregatingMergeTree, CoalescingMergeTree의 병합 중에 Tuple 열의 개별 요소가 집계에 참여해요. 중첩 Tuple은 재귀적으로 확장되어 모든 리프 요소가 독립적으로 집계됩니다. 이 설정은 변경할 수 없으며(immutable) 테이블 생성 시 지정해야 해요.
allow_vertical_merges_from_compact_to_wide_parts
컴팩트 파트에서 와이드 파트로의 세로(vertical) 병합을 허용할지 여부예요. 이 설정은 모든 복제본에서 같은 값이어야 합니다.