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

​
merge_max_block_size

병합된 파트에서 메모리로 읽어 오는 행 수입니다. 가능한 값:
  • 임의의 양의 정수.
머지 작업은 파트에서 merge_max_block_size행 단위의 블록으로 행을 읽은 다음, 이를 병합하여 결과를 새 파트에 기록합니다. 읽기 블록은 RAM에 올라가므로, merge_max_block_size는 머지에 필요한 RAM 크기에 영향을 줍니다. 따라서 행 크기가 매우 큰 테이블에서는 머지 시 많은 양의 RAM을 사용할 수 있습니다 (평균 행 크기가 100kb인 경우, 10개의 파트를 머지하면 (100kb * 10 * 8192) = 약 8GB의 RAM). merge_max_block_size를 줄이면 머지에 필요한 RAM 사용량은 줄일 수 있지만 머지 속도는 느려집니다.

​
merge_max_block_size_bytes

머지 작업에서 형성할 블록의 바이트 수입니다. 기본적으로 index_granularity_bytes와 같은 값입니다.

​
merge_max_bytes_to_prewarm_cache

ClickHouse Cloud에서만 사용할 수 있습니다. 머지 중 캐시를 예열할 파트(compact 또는 패킹)의 최대 크기입니다.

​
merge_max_dynamic_subcolumns_in_compact_part

머지 후 각 컬럼의 Compact 데이터 파트에 생성할 수 있는 동적 서브컬럼의 최대 개수입니다. 이 설정을 사용하면 데이터 타입에 지정된 동적 매개변수와 관계없이 Compact 데이터 파트의 동적 서브컬럼 수를 제어할 수 있습니다. 예를 들어, 테이블에 JSON(max_dynamic_paths=1024) 타입의 컬럼이 있고 merge_max_dynamic_subcolumns_in_compact_part 설정이 128로 되어 있으면, Compact 데이터 파트로 머지된 후 이 파트의 동적 경로 수는 128로 줄어들고 128개의 경로만 동적 서브컬럼으로 기록됩니다.

​
merge_max_dynamic_subcolumns_in_wide_part

머지 후 각 컬럼의 Wide 데이터 파트에서 생성할 수 있는 동적 서브컬럼의 최대 개수입니다. 데이터 타입에 지정된 동적 매개변수와 관계없이 Wide 데이터 파트에서 생성되는 파일 수를 줄일 수 있습니다. 예를 들어, 테이블에 JSON(max_dynamic_paths=1024) 타입의 컬럼이 있고 설정 merge_max_dynamic_subcolumns_in_wide_part가 128로 설정된 경우, Wide 데이터 파트로 머지된 후 이 파트의 동적 경로 수는 128개로 줄어들며, 128개의 경로만 동적 서브컬럼으로 기록됩니다.
마지막 수정일 2026년 7월 23일