Skip to main content
이러한 설정은 system.settings에서 확인할 수 있으며 소스 코드에서 자동 생성됩니다.

​
merge_tree_coarse_index_granularity

데이터를 검색할 때 ClickHouse는 인덱스 파일의 데이터 마크를 확인합니다. 필요한 키가 특정 범위에 있는 것을 발견하면, ClickHouse는 해당 범위를 merge_tree_coarse_index_granularity개의 하위 범위로 나눈 다음 그 안에서 필요한 키를 재귀적으로 검색합니다. 가능한 값:
  • 모든 양의 짝수 정수.

​
merge_tree_compact_parts_min_granules_to_multibuffer_read

이 설정은 ClickHouse Cloud에서만 적용됩니다. 병렬 읽기와 프리페치를 지원하는 멀티버퍼 리더를 사용하기 위한 MergeTree 테이블의 compact 파트 stripe 내 그래뉼 수를 지정합니다. remote fs에서 읽을 때 멀티버퍼 리더를 사용하면 읽기 요청 수가 증가합니다. 파트에 포함된 그래뉼 수가 이 임계값보다 적고, 읽는 컬럼 수보다도 적으면 해당 파트는 단일 버퍼로 읽습니다. 이 경우 단일 버퍼 리더가 멀티버퍼 리더보다 읽기 요청을 더 적게 보내기 때문입니다.

​
merge_tree_determine_task_size_by_prewhere_columns

읽기 작업 크기를 결정할 때 prewhere 컬럼의 크기만 사용할지 여부를 설정합니다.

​
merge_tree_generic_exclusion_search_max_steps

필터를 프라이머리 키의 단일 연속 범위로 평가할 수 없는 경우, 예를 들어 첫 번째가 아닌 키 컬럼을 사용하는 경우 ClickHouse는 인덱스 마크에 대해 반복적인 일반 제외 검색 알고리즘을 실행합니다. 동일한 알고리즘은 텍스트 인덱스 분석에도 사용됩니다. 이 설정은 알고리즘이 각 데이터 파트에 대해 수행하는 단계 수(인덱스 검사 수)를 제한합니다. 예산은 먼저 가장 큰 남은 마크 범위에 사용됩니다. 예산이 소진되면 완전히 분석되지 않은 범위는 전체가 그대로 허용되므로 쿼리의 정확성은 유지되지만, 무제한 검색이 선택했을 때보다 더 많은 그래뉼을 읽을 수 있습니다. 예산을 낮추면 더 많은 데이터를 읽는 대신 인덱스 분석 속도가 빨라집니다. 이 제한은 분석 비용에 대한 엄격한 상한이라기보다 대략적인 값입니다. 검색은 대략 한 번의 분할 라운드 정도 이 한도를 초과할 수 있으며, 파트가 이미 많은 범위로 나뉘어 있는 경우(예: 쿼리 조건 캐시로 인해)에는 제한과 관계없이 각 범위를 최소 한 번씩 검사합니다. 검색이 각 데이터 파트에서 수행한 단계 수는 쿼리의 trace 수준 로그 메시지에 보고되며, IndexGenericExclusionSearchStepLimitReached 및 TextIndexGenericExclusionSearchStepLimitReached profile events는 예산이 소진된 횟수를 집계합니다. (기본) 값 0은 단계 수가 무제한임을 의미합니다. 사용 가능한 값:
  • 무제한 단계를 의미하는 0 또는 임의의 양의 정수.

​
merge_tree_max_bytes_to_use_cache

하나의 쿼리에서 ClickHouse가 merge_tree_max_bytes_to_use_cache바이트를 초과하여 읽어야 하면 비압축 블록 캐시를 사용하지 않습니다. 비압축 블록 캐시는 쿼리용으로 추출된 데이터를 저장합니다. ClickHouse는 이 캐시를 사용해 반복적인 소규모 쿼리의 응답 속도를 높입니다. 이 설정은 많은 양의 데이터를 읽는 쿼리로 인해 캐시가 불필요하게 소모되는 것을 방지합니다. uncompressed_cache_size 서버 설정은 비압축 블록 캐시의 크기를 정의합니다. 가능한 값:
  • 모든 양의 정수.

​
merge_tree_max_rows_to_use_cache

ClickHouse가 하나의 쿼리에서 merge_tree_max_rows_to_use_cache보다 많은 행을 읽어야 하는 경우, 비압축 블록 캐시를 사용하지 않습니다. 비압축 블록 캐시는 쿼리를 위해 추출된 데이터를 저장합니다. ClickHouse는 이 캐시를 사용하여 반복적으로 실행되는 소규모 쿼리의 응답 속도를 높입니다. 이 설정은 많은 양의 데이터를 읽는 쿼리로 인해 캐시가 불필요하게 소모되는 것을 방지합니다. uncompressed_cache_size 서버 설정은 비압축 블록 캐시의 크기를 정의합니다. 가능한 값:
  • 모든 양의 정수.

​
merge_tree_min_bytes_for_concurrent_read

MergeTree 엔진 테이블의 한 파일에서 읽어야 할 바이트 수가 merge_tree_min_bytes_for_concurrent_read를 초과하면, ClickHouse는 여러 스레드를 사용해 이 파일을 동시에 읽으려고 시도합니다. 가능한 값:
  • 양의 정수.

​
merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem

원격 파일 시스템에서 읽을 때 MergeTree 엔진이 병렬 읽기를 수행하기 전에 단일 파일에서 읽어야 하는 최소 바이트 수입니다. 이 설정은 사용하지 않는 것이 좋습니다. 가능한 값:
  • 양의 정수.

​
merge_tree_min_bytes_for_seek

하나의 파일에서 읽어야 하는 두 데이터 블록 사이의 거리가 merge_tree_min_bytes_for_seek 바이트보다 작으면, ClickHouse는 추가 seek을 피하기 위해 두 블록이 모두 포함된 파일 범위를 순차적으로 읽습니다. 가능한 값:
  • 임의의 양의 정수.

​
merge_tree_min_bytes_per_read_stream

바이트 단위로 환산한 스트림별 오버헤드 비용입니다. 일반 로컬 비정렬 MergeTree 스캔에서 생성되는 최대 읽기 스트림 수를 제어합니다. 정렬된 읽기, FINAL, 계층형 읽기 및 병렬 레플리카 읽기에는 적용되지 않습니다. 볼륨 기반 상한은 ceil(sqrt(estimated_read_bytes / this_setting))입니다. ClickHouse는 이 상한 적용 전 요청된 스트림 수의 4분의 1 이상이면서 최소 16개의 스트림을 유지하므로, 실제 스트림 수는 min(requested_streams, max(volume_based_cap, 16, floor(requested_streams / 4)))입니다. 이러한 하한은 비용이 estimated_read_bytes에 반영되지 않는 CPU 집약적 표현식과 집계 작업의 후속 병렬성을 유지합니다. estimated_read_bytes는 인덱스 및 파티션 프루닝 후 남은 마크 범위에서 읽는 컬럼의 압축되지 않은 크기입니다. 스트림별 오버헤드와 스트림당 수행되는 작업량 간의 절충을 위해 압축되지 않은 크기를 사용합니다. 이 작업량은 압축률이 아니라 처리되는 값의 수에 따라 증가하기 때문입니다. 읽기 볼륨을 보수적으로 추정할 수 없는 경우에는 상한이 적용되지 않습니다. 예를 들어 이전 파트에서 새로 추가된 DEFAULT 컬럼을 평가하기 위해 다른 물리적 컬럼이 필요하거나, 선택한 범위가 가변 폭 컬럼의 일부만 읽는 경우입니다. 기본값 64 KB는 T(N) = W/N + F + V·N 비용 모델에서 도출됩니다. 여기서 W는 유효 작업량, F는 고정 파이프라인 오버헤드, V는 스트림별 가변 비용입니다. 최적의 스트림 수는 sqrt(W/V)입니다. 처리량을 통해 W를 바이트로 표현하면 C = throughput · V ≈ 400 MB/s · 0.17 ms ≈ 64 KB가 됩니다. 이 값을 늘리면 스트림 수가 줄어들어 더 보수적으로 동작하며, 줄이면 더 많은 스트림을 허용합니다. 이 최적화를 비활성화하려면 0으로 설정하십시오. 가능한 값:
  • 음이 아닌 정수.

​
merge_tree_min_bytes_per_task_for_remote_reading

별칭: filesystem_prefetch_min_bytes_for_single_read_task 작업당 읽을 최소 바이트 수입니다.

​
merge_tree_min_read_task_size

작업 크기의 엄격한 하한값입니다(그래뉼 수가 적고 사용 가능한 스레드 수가 많더라도 더 작은 작업은 할당하지 않습니다

​
merge_tree_min_rows_for_concurrent_read

MergeTree 테이블 파일에서 읽어야 할 행 수가 merge_tree_min_rows_for_concurrent_read를 초과하면 ClickHouse는 여러 스레드를 사용해 해당 파일을 동시에 읽으려고 시도합니다. 가능한 값:
  • 양의 정수.

​
merge_tree_min_rows_for_concurrent_read_for_remote_filesystem

원격 파일 시스템에서 읽는 경우, MergeTree 엔진이 읽기를 병렬화하기 전에 하나의 파일에서 읽어야 하는 최소 행 수입니다. 이 설정의 사용은 권장하지 않습니다. 가능한 값:
  • 양의 정수.

​
merge_tree_min_rows_for_seek

하나의 파일에서 읽어야 하는 두 데이터 블록 사이의 거리가 merge_tree_min_rows_for_seek행보다 작으면, ClickHouse는 파일에서 읽기 위치를 이동하지 않고 데이터를 순차적으로 읽습니다. 가능한 값:
  • 임의의 양의 정수.

​
merge_tree_prefetch_json_shared_data_substreams

마크를 탐색해 읽는 Wide 파트의 JSON 공유 데이터 서브스트림에 대한 프리페치를 활성화합니다. 이러한 프리페치는 그래뉼의 시작 부분부터 읽지만, 일반적으로 서브스트림을 읽는 위치와는 다르므로 불필요할 수 있습니다. 이러한 프리페치를 건너뛰려면 비활성화하십시오.

​
merge_tree_read_split_ranges_into_intersecting_and_non_intersecting_injection_probability

PartsSplitter 테스트용으로, 지정한 확률에 따라 MergeTree에서 읽을 때마다 읽기 범위를 서로 겹치는 범위와 겹치지 않는 범위로 분할합니다.

​
merge_tree_storage_snapshot_sleep_ms

MergeTree 테이블의 스토리지 스냅샷을 생성할 때 인위적인 지연을 추가합니다(밀리초). 테스트 및 디버깅 용도로만 사용하십시오. 가능한 값:
  • 0 - 지연 없음(기본값)
  • N - 밀리초 단위 지연

​
merge_tree_use_const_size_tasks_for_remote_reading

원격 테이블에서 읽을 때 일정한 크기의 작업을 사용할지 여부입니다.

​
merge_tree_use_deserialization_prefixes_cache

MergeTree에서 원격 디스크를 읽을 때 파일 프리픽스의 컬럼 메타데이터를 캐시하도록 활성화합니다.

​
merge_tree_use_prefixes_deserialization_thread_pool

MergeTree의 Wide 파트에서 프리픽스를 병렬로 읽을 때 스레드 풀을 사용하도록 설정합니다. 해당 스레드 풀의 크기는 서버 설정 max_prefixes_deserialization_thread_pool_size로 제어됩니다.

​
merge_tree_use_v1_object_and_dynamic_serialization

활성화하면 MergeTree에서 JSON 및 Dynamic 타입에 V2 대신 V1 직렬화 버전이 사용됩니다. 이 설정 변경은 서버를 다시 시작한 후에만 적용됩니다.
마지막 수정일 2026년 8월 18일