shared_merge_* MergeTree 테이블 설정

이 설정은 system.merge_tree_settings에서 확인할 수 있으며, ClickHouse 소스에서 자동 생성됩니다.

shared_merge_tree_activate_coordinated_merges_tasks

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.9	0	새로운 설정
25.8	0	새로운 설정
25.7	0	새로운 설정
25.6	0	새로운 설정
25.10	0	새로운 설정

조정된 머지 작업의 재스케줄링을 활성화합니다. 이는 shared_merge_tree_enable_coordinated_merges=0인 경우에도 유용할 수 있습니다. 머지 코디네이터 통계를 채워 콜드 스타트에 도움이 되기 때문입니다.

shared_merge_tree_blobs_list_inline_file_max_bytes

유형

UInt64

기본값

버전 이력

버전	기본값	설명
26.9	0	blob-list 파트의 작은 파일을 별도 blob 대신 통합된 blobs.list에 인라인으로 저장하는 새로운 설정

blob-list 파트의 파일 중 크기가 이 바이트 수 이하인 파일(예: count.txt, metadata_version.txt, MinMax 인덱스)을 별도의 객체 스토리지 blob 대신 통합된 blobs.list 파일에 직접 인라인으로 저장합니다. 이를 통해 작은 파일마다 blob 쓰기와 읽기를 각각 1회 절약할 수 있습니다. 0으로 설정하면 인라인 저장이 비활성화됩니다. blob-list 스토리지를 사용하는 파트에만 적용됩니다(참조: shared_merge_tree_use_blobs_list_for_parts). ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_create_per_replica_metadata_nodes

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.11	0	Keeper의 메타데이터 양을 줄입니다.
25.1	1	Cloud sync

ZooKeeper에서 레플리카별 /metadata 및 /columns 노드를 생성할 수 있도록 합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_disable_merges_and_mutations_assignment

유형

Bool

기본값

shared merge tree의 머지 및 뮤테이션 할당을 중지합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_empty_partition_lifetime

유형

Seconds

기본값

86400

버전 이력

버전	기본값	설명
25.9	86400	새로운 설정

파트가 없는 파티션을 Keeper에 몇 초 동안 저장할지 지정합니다.

shared_merge_tree_enable_automatic_empty_partitions_cleanup

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.2	1	기본적으로 활성화
25.9	0	새로운 설정

빈 파티션의 Keeper 항목 정리를 활성화합니다.

shared_merge_tree_enable_coordinated_merges

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.6	1	기본적으로 조정된 머지 사용
25.5	0	새로운 설정

조정된 머지 전략을 사용하도록 설정합니다

shared_merge_tree_enable_keeper_parts_extra_data

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.6	1	기본적으로 조정된 머지를 활성화합니다
25.3	0	새로운 설정

가상 파트에 속성을 기록하고 Keeper에 블록을 커밋하도록 활성화합니다

shared_merge_tree_enable_outdated_parts_check

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.1	1	Cloud sync

오래된 파트 검사를 활성화합니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_idle_parts_update_seconds

유형

UInt64

기본값

3600

버전 이력

버전	기본값	설명
25.1	3600	Cloud sync

shared merge tree에서 ZooKeeper watch에 의해 트리거되지 않는 파트 업데이트의 초 단위 인터벌입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_inactive_replica_cutoff_seconds

유형

Seconds

기본값

버전 이력

버전	기본값	설명
26.6	0	비활성 레플리카를 백그라운드 정리 작업에서 얼마나 오래 고려할지 제어하는 새로운 설정입니다 (0은 ZooKeeper 세션 타임아웃 2회를 의미합니다)

백그라운드 정리 작업(OutdatedPartsQuorumThread)에서 비활성 레플리카를 계속 고려하는 기간을 지정합니다: 레플리카가 이 값보다 짧은 시간 동안 비활성 상태였다면, 오래된 파트의 제거와 완료된 뮤테이션의 정리를 계속 지연시킵니다. 값이 0이면 기본값인 ZooKeeper 세션 타임아웃 2회를 사용합니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_initial_parts_update_backoff_ms

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.2	50	새로운 설정

파트 업데이트의 초기 백오프입니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_interserver_http_connection_timeout_ms

유형

UInt64

기본값

100

버전 이력

버전	기본값	설명
25.2	100	새로운 설정

interserver HTTP connection의 시간 초과를 설정합니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_interserver_http_timeout_ms

유형

UInt64

기본값

10000

버전 이력

버전	기본값	설명
25.1	10000	Cloud sync

interserver HTTP 통신의 시간 제한입니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_leader_update_period_random_add_seconds

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	10	Cloud sync

thundering herd 효과를 방지하기 위해 shared_merge_tree_leader_update_period에 0초에서 x초 사이의 균등 분포 값을 추가합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_leader_update_period_seconds

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	30	Cloud sync

파트 업데이트 시 리더를 다시 확인하는 최대 주기입니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_max_outdated_parts_to_process_at_once

유형

UInt64

기본값

1000

버전 이력

버전	기본값	설명
25.1	1000	Cloud sync

리더가 한 번의 HTTP 요청에서 제거 대상으로 확인하려고 시도하는 오래된 파트의 최대 개수입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_max_parts_update_backoff_ms

유형

UInt64

기본값

5000

버전 이력

버전	기본값	설명
25.2	5000	새로운 설정

파트 업데이트의 최대 백오프 시간입니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_max_parts_update_leaders_in_total

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	6	Cloud sync

파트 업데이트 리더의 최대 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_max_parts_update_leaders_per_az

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	2	Cloud sync

parts update leaders의 최대 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_max_replicas_for_parts_deletion

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	10	Cloud sync

파트 삭제(killer thread)에 참여하는 최대 레플리카 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	5	Cloud sync

잠재적으로 충돌할 수 있는 머지를 할당하려고 시도하는 최대 레플리카 수입니다(머지 할당에서 불필요한 충돌을 방지하는 데 도움이 됩니다). 0은 비활성화를 의미합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_max_suspicious_broken_parts

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.2	0	SMT의 손상된 파트 최대 수입니다. 이 값을 초과하면 자동 detach가 거부됩니다.

SMT의 손상된 파트 최대 수입니다. 이 값을 초과하면 자동 detach가 거부됩니다.

shared_merge_tree_max_suspicious_broken_parts_bytes

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.2	0	SMT의 모든 손상된 파트의 최대 크기입니다. 이 값을 초과하면 자동 detach를 허용하지 않습니다.

SMT의 모든 손상된 파트의 최대 크기입니다. 이 값을 초과하면 자동 detach를 허용하지 않습니다.

shared_merge_tree_memo_ids_remove_timeout_seconds

유형

Int64

기본값

1800

버전 이력

버전	기본값	설명
25.1	1800	Cloud sync

삽입 재시도 시 잘못된 동작을 방지하기 위해 삽입 메모이제이션 ID를 저장하는 기간입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_merge_coordinator_distribution_algorithm

유형

MergeCoordinatorDistributionAlgorithm

기본값

sainte_lague

버전 이력

버전	기본값	설명
26.8	sainte_lague	기본적으로 Sainte-Lague 분배를 활성화합니다.
26.7	water_filling	머지 코디네이터가 레플리카 간 머지를 분배할 때 사용할 알고리즘을 제어하는 새로운 설정

머지 코디네이터 스레드가 레플리카 간 머지를 분배하는 데 사용하는 알고리즘입니다.

가능한 값:

water_filling
sainte_lague

shared_merge_tree_merge_coordinator_election_check_period_ms

유형

Milliseconds

기본값

30000

버전 이력

버전	기본값	설명
25.5	30000	새로운 설정

머지 코디네이터 선출 스레드의 실행 간격

shared_merge_tree_merge_coordinator_factor

유형

Float

기본값

1.1

버전 이력

버전	기본값	설명
25.5	1.100000023841858	새로운 설정
25.10	1.100000023841858	부하 후 coordinator sleep 시간 감소

coordinator thread 지연 시간의 변경 계수

shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms

유형

Milliseconds

기본값

10000

버전 이력

버전	기본값	설명
25.5	10000	새로운 설정

머지 코디네이터가 최신 메타데이터를 가져오기 위해 ZooKeeper와 동기화하는 주기

shared_merge_tree_merge_coordinator_max_merge_request_size

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.5	20	새로운 설정

coordinator가 한 번에 MergerMutator에 요청할 수 있는 머지 수

shared_merge_tree_merge_coordinator_max_period_ms

유형

Milliseconds

기본값

10000

버전 이력

버전	기본값	설명
25.5	10000	새로운 설정

머지 코디네이터 스레드 실행 간 최대 시간

shared_merge_tree_merge_coordinator_merges_prepare_count

유형

UInt64Auto

기본값

auto

버전 이력

버전	기본값	설명
26.4	auto	설정을 auto로 지정: 레플리카당 최대 머지 작업 수 * 활성 레플리카 수
25.5	100	새로운 설정

coordinator가 준비하여 worker들에 분배할 머지 항목 수입니다. 'auto'로 설정하면 단일 레플리카에서 허용되는 최대 머지 작업 수에 활성 레플리카 수를 곱한 값과 같습니다.

shared_merge_tree_merge_coordinator_min_period_ms

유형

Milliseconds

기본값

버전 이력

버전	기본값	설명
25.5	1	새로운 설정

머지 코디네이터 스레드 실행 간 최소 시간

shared_merge_tree_merge_worker_fast_timeout_ms

유형

Milliseconds

기본값

100

버전 이력

버전	기본값	설명
25.5	100	새로운 설정

즉시 작업 후 상태를 업데이트해야 할 때 머지 작업자 스레드가 사용하는 타임아웃

shared_merge_tree_merge_worker_regular_timeout_ms

유형

Milliseconds

기본값

10000

버전 이력

버전	기본값	설명
25.5	10000	새로운 설정

머지 작업자 스레드의 실행 간격

shared_merge_tree_outdated_parts_group_size

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.9	2	새로운 설정

오래된 파트 정리 시 동일한 rendezvous hash 그룹에 속하는 레플리카 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations

유형

Float

기본값

0.5

<candidate partitions for mutations only (partitions that cannot be merged)>/<candidate partitions for mutations> 비율이 이 설정보다 높으면, 머지/뮤테이션 선택 작업에서 머지 프레디케이트를 다시 로드합니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_parts_load_batch_size

유형

UInt64

기본값

한 번에 스케줄링할 fetch 파트 메타데이터 작업 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	0	Cloud sync

이 파트를 포함하는 새 머지를 시작하지 않고 로컬에서 병합된 파트를 유지하는 시간입니다. 다른 레플리카가 이 파트를 가져와 이 머지를 시작할 수 있도록 합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold

유형

UInt64

기본값

1000000

버전 이력

버전	기본값	설명
25.1	1000000	Cloud sync

로컬에서 파트를 머지한 직후 다음 머지를 할당하지 않도록 연기하는 파트의 최소 크기(행 수)입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_range_for_merge_window_size

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.1	10	Cloud sync

레플리카 간에 머지 할당을 분산하는 데 사용되는 윈도우 크기(블록 번호 단위)입니다. 같은 윈도우 내의 파트는 동일한 레플리카에 할당됩니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_read_virtual_parts_from_leader

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.1	1	Cloud sync

가능한 경우 리더에서 가상 파트를 읽습니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_replica_set_max_lifetime_seconds

유형

Seconds

기본값

1800

버전 이력

버전	기본값	설명
26.4	1800	기본 레플리카 세트 백그라운드 업데이트 인터벌을 30분으로 늘림
26.2	300	새로운 설정

레플리카가 백그라운드에서 레플리카 세트를 업데이트하려고 시도하는 주기입니다. 다음 실행 시점에는 [0, value]초 범위에서 균등하게 지터가 적용됩니다. 예외적으로 value = 0은 이 규칙을 따르지 않으며, 구현상 최소 200ms가 적용되므로 다음 실행 시점에는 [0, 200]ms 범위에서 지터가 적용됩니다.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.1	0	다른 레플리카에서 파트의 인메모리 데이터를 가져오기 위한 새로운 설정

활성화되면 모든 레플리카는 해당 데이터가 이미 있는 다른 레플리카에서 파트의 인메모리 데이터(프라이머리 키, 파티션 정보 등)를 가져오려고 시도합니다.

shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.6	0	시작 시 SMT가 S3 대신 레플리카에서 파트 데이터를 다운로드할 수 있게 하는 새로운 설정

활성화되면 모든 레플리카는 시작 시 이미 해당 데이터가 있는 다른 레플리카로부터 파트의 인메모리 데이터(프라이머리 키, 파티션 정보 등)를 가져오려고 시도합니다.

shared_merge_tree_update_replica_flags_delay_ms

유형

Milliseconds

기본값

30000

버전 이력

버전	기본값	설명
25.8	30000	새로운 설정

레플리카가 백그라운드 스케줄에 따라 플래그를 다시 로드하려고 시도하는 간격입니다.

shared_merge_tree_use_blobs_list_for_parts

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.9	0	SharedMergeTree 파트의 파일별 blob 맵을 파일마다 하나의 노드에 저장하는 대신, 하나의 통합된 Keeper 노드에 저장하는 새로운 설정

SharedMergeTree 테이블의 파트(Wide 및 Compact 모두)를 파일마다 하나의 Keeper 노드에 저장하는 대신, 하나의 통합된 blob-list 메타데이터 노드로 저장합니다. 파일마다 객체 스토리지 blob은 하나씩 유지하면서 파트별 Keeper 메타데이터를 O(파일 수)에서 작은 상수로 줄입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_use_metadata_hints_cache

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.1	1	Cloud sync

다른 레플리카의 인메모리 캐시에서 FS 캐시 힌트를 요청할 수 있도록 합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_use_outdated_parts_compact_format

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.9	1	기본적으로 오래된 파트 v3를 활성화합니다
25.1	0	Cloud sync

오래된 파트에 compact 포맷을 사용합니다: Keeper의 부하를 줄이고 오래된 파트 처리를 개선합니다. ClickHouse Cloud에서만 사용할 수 있습니다

shared_merge_tree_use_too_many_parts_count_from_virtual_parts

유형

Bool

기본값

버전 이력

버전	기본값	설명
25.1	0	Cloud sync

활성화하면 Too many parts 카운터는 로컬 레플리카 상태가 아니라 Keeper의 공유 데이터를 사용합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

shared_merge_tree_use_zookeeper_connection_pool

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.3	0	새로운 설정

활성화하면 SharedMergeTree는 서버 수준의 ZooKeeper 세션 풀 중 하나를 사용합니다.

shared_merge_tree_virtual_parts_discovery_batch

유형

UInt64

기본값

버전 이력

버전	기본값	설명
25.8	1	새로운 설정

하나의 배치에 패킹할 파티션 디스커버리 수

shared_merge_tree_virtual_parts_partition_atomic_discovery

유형

Bool

기본값

버전 이력

버전	기본값	설명
26.7	1	새로운 설정

더 이상 사용되지 않는 설정으로, 아무런 작업도 수행하지 않습니다.