> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# min_insert_* 세션 설정

> min_insert_* 생성 그룹에 속한 ClickHouse 세션 설정입니다.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이 설정들은 [system.settings](/docs/ko/reference/system-tables/settings)에서 확인할 수 있으며, [소스 코드](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)로부터 자동으로 생성됩니다.

<div id="min_insert_block_size_bytes">
  ## min\_insert\_block\_size\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="268402944" />

테이블에 삽입할 때 생성되는 블록의 최소 크기(바이트 단위)입니다.

이 설정은 min\_insert\_block\_size\_rows와 함께 작동하며, 동일한 컨텍스트(포맷 파싱 및 INSERT 작업)에서 블록 형성을 제어합니다. 이러한 설정이 언제, 어떻게 적용되는지에 대한 자세한 내용은 min\_insert\_block\_size\_rows를 참조하십시오.

가능한 값:

* 양의 정수입니다.
* 0 — 이 설정은 블록 형성에 관여하지 않습니다.

<div id="min_insert_block_size_bytes_for_materialized_views">
  ## min\_insert\_block\_size\_bytes\_for\_materialized\_views
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

`INSERT` 쿼리로 테이블에 삽입할 수 있는 블록의 최소 바이트 수를 설정합니다. 크기가 더 작은 블록은 더 큰 블록으로 병합됩니다. 이 설정은 [materialized view](/docs/ko/reference/statements/create/view)에 삽입되는 블록에만 적용됩니다. 이 설정을 조정하면 materialized view로 푸시할 때 블록 병합을 제어하고 과도한 메모리 사용량을 방지할 수 있습니다.

가능한 값:

* 임의의 양의 정수.
* 0 — 병합 비활성화.

**관련 항목**

* [min\_insert\_block\_size\_bytes](/docs/ko/reference/settings/session-settings/min-insert#min_insert_block_size_bytes)

<div id="min_insert_block_size_rows">
  ## min\_insert\_block\_size\_rows
</div>

<SettingsInfoBlock type="UInt64" default_value="1048449" />

테이블에 삽입할 때 형성되는 블록의 최소 크기(행 수)입니다.

이 설정은 다음 두 가지 상황에서 블록 형성을 제어합니다.

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 — 이 설정은 블록 형성에 사용되지 않습니다.

<div id="min_insert_block_size_rows_for_materialized_views">
  ## min\_insert\_block\_size\_rows\_for\_materialized\_views
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

`INSERT` 쿼리로 테이블에 삽입할 수 있는 블록의 최소 행 수를 설정합니다. 이보다 작은 블록은 더 큰 블록으로 합쳐집니다. 이 설정은 [materialized view](/docs/ko/reference/statements/create/view)에 삽입되는 블록에만 적용됩니다. 이 설정을 조정하면 materialized view로 푸시할 때 블록 합치기를 제어하여 과도한 메모리 사용량을 방지할 수 있습니다.

가능한 값:

* 임의의 양의 정수.
* 0 — 블록 합치기 비활성화.

**관련 항목**

* [min\_insert\_block\_size\_rows](/docs/ko/reference/settings/session-settings/min-insert#min_insert_block_size_rows)