> ## 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.

# настройки сеанса max_insert_*

> Настройки сеанса ClickHouse в сгенерированной группе max_insert_*.

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/ru/reference/system-tables/settings) и автоматически генерируются из [исходного кода](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="max_insert_block_size">
  ## max\_insert\_block\_size
</div>

**Псевдонимы**: `max_insert_block_size_rows`

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

Максимальный размер блоков (по числу строк), формируемых для вставки в таблицу.

Этот параметр управляет формированием блоков в двух контекстах:

1. Разбор форматов: когда сервер разбирает входные построчные форматы (CSV, TSV, JSONEachRow и т. д.) через любой интерфейс (HTTP, clickhouse-client со встроенными данными, gRPC, PostgreSQL wire protocol), блоки формируются, когда:

   * Достигнуты оба порога: 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 views поведение этого параметра зависит от `use_strict_insert_block_limits`:

   * Когда включено: блоки формируются, когда:
     * Минимальные пороги (И): достигнуты оба значения min\_insert\_block\_size\_rows И min\_insert\_block\_size\_bytes
     * Максимальные пороги (ИЛИ): достигнуто либо значение max\_insert\_block\_size\_rows, либо max\_insert\_block\_size\_bytes

   * Когда отключено: блоки формируются, когда достигнуто значение min\_insert\_block\_size\_rows ИЛИ min\_insert\_block\_size\_bytes. Параметры max\_insert\_block\_size не применяются.

Возможные значения:

* Положительное целое число.

<div id="max_insert_block_size_bytes">
  ## max\_insert\_block\_size\_bytes
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "0"},{"label": "Новая настройка, позволяющая управлять размером блоков в байтах при разборе данных в формате Row Input Format."}]}]} />

Максимальный размер блоков (в байтах), формируемых для вставки в таблицу.

Эта настройка работает вместе с max\_insert\_block\_size\_rows и управляет формированием блоков в одном и том же контексте. Подробную информацию о том, когда и как применяются эти настройки, см. в описании max\_insert\_block\_size\_rows.

Возможные значения:

* Положительное целое число.
* 0 — настройка не участвует в формировании блоков.

<div id="max_insert_delayed_streams_for_parallel_write">
  ## max\_insert\_delayed\_streams\_for\_parallel\_write
</div>

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

Максимальное количество потоков (столбцов), для которых откладывается финальный сброс части. По умолчанию — auto (100, если нижележащее хранилище поддерживает параллельную запись, например S3, в противном случае отключено)

Значение по умолчанию в Cloud: `50`.

<div id="max_insert_threads">
  ## max\_insert\_threads
</div>

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

Максимальное количество потоков для выполнения запроса `INSERT SELECT`.

Возможные значения:

* 0 (или 1) — для `INSERT SELECT` параллельное выполнение не используется.
* Положительное целое число, больше 1.

Значение по умолчанию в Cloud:

* `1` для узлов с 8 GiB памяти
* `2` для узлов с 16 GiB памяти
* `4` для более крупных узлов

Параллельный `INSERT SELECT` работает только в том случае, если часть `SELECT` также выполняется параллельно, см. настройку [`max_threads`](/docs/ru/reference/settings/session-settings/max-threads#max_threads).
Более высокие значения приводят к большему использованию памяти.

<div id="max_insert_threads_min_free_memory_per_thread">
  ## max\_insert\_threads\_min\_free\_memory\_per\_thread
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "4294967296"},{"label": "Новая настройка для ограничения числа потоков вставки в зависимости от объёма доступной свободной памяти"}]}]} />

То же, что и `max_threads_min_free_memory_per_thread`, но применяется к `max_insert_threads`, а не к `max_threads`. Значение по умолчанию выше, поскольку конвейеры вставки обычно используют более крупные буферы на поток (части MergeTree, блоки сжатия), чем конвейеры чтения.

Если объём свободной памяти меньше, чем `max_insert_threads`, умноженное на это значение, `max_insert_threads` уменьшается до допустимого значения, но не ниже `1`.

Установите `0`, чтобы отключить это ограничение.