number_of MergeTree 설정
number_of MergeTree 설정 (number_of_* MergeTree settings)
이 문서는 풀의 여유 항목 수와 뮤테이션 개수에 따른 동작과 관련된 MergeTree 설정들을 다루는 페이지예요. 뮤테이션 실행, 파티션 최적화, 병합 최대 크기 하향, 뮤테이션 지연·중단 등을 제어합니다.
출처: 문서
본문
이 설정들은 system.merge_tree_settings에서 확인할 수 있으며 ClickHouse 소스에서 자동 생성됩니다.
number_of_free_entries_in_pool_to_execute_mutation
풀의 여유 항목 수가 지정된 수보다 적으면 파트 뮤테이션을 실행하지 않아요. 일반 병합을 위한 여유 스레드를 남겨두고 "Too many parts" 오류를 피하기 위함이에요. 가능한 값:
- 양의 정수.
Usage
number_of_free_entries_in_pool_to_execute_mutation 설정의 값은 background_pool_size와 background_merges_mutations_concurrency_ratio의 곱을 초과하면 안 됩니다. 그렇지 않으면 ClickHouse가 예외를 던져요.
number_of_free_entries_in_pool_to_execute_optimize_entire_partition
풀의 여유 항목 수가 지정된 수보다 적으면 백그라운드에서 전체 파티션 최적화를 실행하지 않아요(이 작업은 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와 background_merges_mutations_concurrency_ratio의 곱을 초과하면 안 됩니다. 그렇지 않으면 ClickHouse가 예외를 던져요.
number_of_free_entries_in_pool_to_lower_max_size_of_merge
풀(또는 복제 큐)의 여유 항목 수가 지정된 수보다 적으면, 처리(또는 큐에 넣기)할 병합의 최대 크기를 낮추기 시작해요. 이는 오래 걸리는 병합으로 풀을 채우지 않고 작은 병합이 처리되도록 하기 위함입니다. 가능한 값:
- 양의 정수.
number_of_mutations_to_delay
테이블에 그만큼 이상의 미완료 뮤테이션이 있으면 테이블의 뮤테이션을 인위적으로 느리게 해요. 0으로 설정하면 비활성화됩니다.
number_of_mutations_to_throw
테이블에 그만큼 이상의 미완료 뮤테이션이 있으면 ‘Too many mutations’ 예외를 던져요. 0으로 설정하면 비활성화됩니다.
number_of_partitions_to_consider_for_merge
ClickHouse Cloud에서만 사용할 수 있어요. 병합을 고려할 상위 N개 파티션까지예요. 파티션은 가중치가 이 파티션에서 병합할 수 있는 데이터 파트 수인 무작위 가중 방식으로 선택됩니다.