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

​
min_insert_block_size_bytes

테이블에 삽입할 때 생성되는 블록의 최소 크기(바이트 단위)입니다. 이 설정은 min_insert_block_size_rows와 함께 작동하며, 동일한 컨텍스트(포맷 파싱 및 INSERT 작업)에서 블록 형성을 제어합니다. 이러한 설정이 언제, 어떻게 적용되는지에 대한 자세한 내용은 min_insert_block_size_rows를 참조하십시오. 가능한 값:
  • 양의 정수입니다.
  • 0 — 이 설정은 블록 형성에 관여하지 않습니다.

​
min_insert_block_size_bytes_for_materialized_views

INSERT 쿼리로 테이블에 삽입할 수 있는 블록의 최소 바이트 수를 설정합니다. 크기가 더 작은 블록은 더 큰 블록으로 병합됩니다. 이 설정은 materialized view에 삽입되는 블록에만 적용됩니다. 이 설정을 조정하면 materialized view로 푸시할 때 블록 병합을 제어하고 과도한 메모리 사용량을 방지할 수 있습니다. 가능한 값:
  • 임의의 양의 정수.
  • 0 — 병합 비활성화.
관련 항목

​
min_insert_block_size_rows

테이블에 삽입할 때 형성되는 블록의 최소 크기(행 수)입니다. 이 설정은 다음 두 가지 상황에서 블록 형성을 제어합니다.
  1. 포맷 파싱: 서버가 모든 인터페이스(HTTP, 인라인 데이터를 사용하는 clickhouse-client, gRPC, PostgreSQL wire 프로토콜)로부터 행 기반 입력 형식(CSV, TSV, JSONEachRow 등)을 파싱할 때, 다음 조건에서 블록이 생성됩니다.
    • min_insert_block_size_rows AND min_insert_block_size_bytes가 모두 충족되는 경우, OR
    • max_insert_block_size_rows OR max_insert_block_size_bytes 중 하나가 충족되는 경우
    참고: clickhouse-client 또는 clickhouse-local로 파일에서 데이터를 읽는 경우에는 클라이언트 자체가 데이터를 파싱하므로, 이 설정은 클라이언트 측에 적용됩니다.
  2. INSERT 작업: INSERT 쿼리 수행 중이거나 데이터가 materialized view를 통과할 때, 이 설정의 동작은 use_strict_insert_block_limits에 따라 달라집니다.
    • 활성화된 경우: 다음 조건에서 블록이 생성됩니다.
      • 최소 임계값(AND): min_insert_block_size_rows AND min_insert_block_size_bytes가 모두 충족됨
      • 최대 임계값(OR): max_insert_block_size_rows OR max_insert_block_size_bytes 중 하나가 충족됨
    • 비활성화된 경우(기본값): min_insert_block_size_rows OR min_insert_block_size_bytes가 충족되면 블록이 생성됩니다. max_insert_block_size 설정은 적용되지 않습니다.
가능한 값:
  • 양의 정수입니다.
  • 0 — 이 설정은 블록 형성에 사용되지 않습니다.

​
min_insert_block_size_rows_for_materialized_views

INSERT 쿼리로 테이블에 삽입할 수 있는 블록의 최소 행 수를 설정합니다. 이보다 작은 블록은 더 큰 블록으로 합쳐집니다. 이 설정은 materialized view에 삽입되는 블록에만 적용됩니다. 이 설정을 조정하면 materialized view로 푸시할 때 블록 합치기를 제어하여 과도한 메모리 사용량을 방지할 수 있습니다. 가능한 값:
  • 임의의 양의 정수.
  • 0 — 블록 합치기 비활성화.
관련 항목
마지막 수정일 2026년 7월 23일