Skip to main content
이러한 설정은 system.settings에서 제공되며, 소스에서 자동 생성됩니다.

​
max_partitions_per_insert_block

단일 삽입 블록에서 허용되는 최대 파티션 수를 제한합니다. 블록에 파티션이 너무 많이 포함되어 있으면 예외가 발생합니다.
  • 양의 정수입니다.
  • 0 — 파티션 수에 제한이 없습니다.
세부 정보 데이터를 삽입할 때 ClickHouse는 삽입된 블록에 포함된 파티션 수를 계산합니다. 파티션 수가 max_partitions_per_insert_block보다 크면 ClickHouse는 throw_on_max_partitions_per_insert_block 설정에 따라 경고를 로그에 기록하거나 예외를 발생시킵니다. 예외 메시지는 다음과 같습니다.
“단일 INSERT 블록에 대한 파티션 수가 너무 많습니다 (partitions_count partitions, limit is ” + toString(max_partitions) + ”). 이 제한은 ‘max_partitions_per_insert_block’ 설정으로 제어됩니다. 많은 수의 파티션을 사용하는 것은 흔히 하는 오해입니다. 이로 인해 서버 시작이 느려지고, INSERT 쿼리와 SELECT 쿼리 성능이 저하되는 등 심각한 성능 문제가 발생합니다. 테이블의 전체 파티션 수는 일반적으로 1000..10000 미만으로 유지하는 것이 좋습니다. 또한 파티셔닝은 SELECT 쿼리를 빠르게 하기 위한 기능이 아니라는 점에 유의하십시오 (범위 쿼리를 빠르게 만드는 데는 ORDER BY key로 충분합니다). 파티션은 데이터 조작(DROP PARTITION 등)을 위한 것입니다.”
많은 수의 파티션을 사용하는 것은 흔히 하는 오해이므로, 이 설정은 안전 임계값입니다.

​
max_partitions_to_read

단일 쿼리에서 액세스할 수 있는 파티션의 최대 수를 제한합니다. 테이블 생성 시 지정한 설정 값은 쿼리 수준 설정으로 재정의할 수 있습니다. 가능한 값:
  • 양의 정수
  • -1 - 무제한(기본값)
MergeTree 설정 max_partitions_to_read은 테이블 설정에서도 지정할 수 있습니다.
마지막 수정일 2026년 7월 23일