> ## 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/ja/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/ja/reference/statements/create/view) に挿入されるブロックにのみ適用されます。この設定を調整することで、materialized view への書き込み時のブロックのまとめ方を制御し、過剰なメモリ使用量を防ぐことができます。

設定可能な値:

* 任意の正の整数。
* 0 — まとめる処理を無効にします。

**関連項目**

* [min\_insert\_block\_size\_bytes](/docs/ja/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" />

テーブルに挿入するために形成されるブロックの最小サイズ (行数) 。

この設定は、次の 2 つのコンテキストでの ブロック形成 を制御します。

1. フォーマットのパース: サーバーが任意のインターフェイス (HTTP、インラインデータ付きの clickhouse-client、gRPC、PostgreSQL ワイヤプロトコル) から行ベースの入力フォーマット (CSV、TSV、JSONEachRow など) をパースする際、ブロックは次の場合に生成されます。

   * min\_insert\_block\_size\_rows と min\_insert\_block\_size\_bytes の両方に達した場合、または
   * max\_insert\_block\_size\_rows または 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 と min\_insert\_block\_size\_bytes の両方に達した場合
     * 最大しきい値 (OR) : max\_insert\_block\_size\_rows または max\_insert\_block\_size\_bytes のいずれか一方に達した場合

   * 無効な場合 (デフォルト) : ブロックは min\_insert\_block\_size\_rows または 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/ja/reference/statements/create/view) に挿入されるブロックにのみ適用されます。この設定を調整することで、materialized view へプッシュする際のブロックのまとめ方を制御し、過剰なメモリ使用量を防ぐことができます。

設定可能な値:

* 任意の正の整数。
* 0 — ブロックのまとめを無効にします。

**関連項目**

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