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

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

> Настройки сеанса ClickHouse в автоматически созданной группе 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="insert_allow_materialized_columns">
  ## insert\_allow\_materialized\_columns
</div>

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

Если параметр включен, разрешается вставка в материализованные столбцы.

<div id="insert_deduplicate">
  ## insert\_deduplicate
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

Включает или отключает дедупликацию блоков при `вставке` (для таблиц Replicated\*).

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

* 0 — Отключено.
* 1 — Включено.

По умолчанию блоки, вставленные в реплицируемые таблицы оператором `вставки`, дедуплицируются (см. [Репликация данных](/docs/ru/reference/engines/table-engines/mergetree-family/replication)).
Для реплицируемых таблиц по умолчанию дедуплицируются только 100 последних блоков для каждой партиции (см. [replicated\_deduplication\_window](/docs/ru/reference/settings/merge-tree-settings#replicated_deduplication_window), [replicated\_deduplication\_window\_seconds](/docs/ru/reference/settings/merge-tree-settings#replicated_deduplication_window_seconds)).
Для нереплицируемых таблиц см. [non\_replicated\_deduplication\_window](/docs/ru/reference/settings/merge-tree-settings#non_replicated_deduplication_window).

<div id="insert_deduplication_token">
  ## insert\_deduplication\_token
</div>

Эта настройка позволяет пользователю задать собственную логику дедупликации в MergeTree/ReplicatedMergeTree.
Например, указывая уникальное значение этой настройки в каждом операторе вставки,
пользователь может сделать так, чтобы одинаковые вставляемые данные не дедуплицировались.

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

* Любая строка

`insert_deduplication_token` используется для дедупликации *только* если он не пуст.

Для реплицируемых таблиц по умолчанию дедуплицируются только 100 самых последних вставок для каждой партиции (см. [replicated\_deduplication\_window](/docs/ru/reference/settings/merge-tree-settings#replicated_deduplication_window), [replicated\_deduplication\_window\_seconds](/docs/ru/reference/settings/merge-tree-settings#replicated_deduplication_window_seconds)).
Для нереплицируемых таблиц см. [non\_replicated\_deduplication\_window](/docs/ru/reference/settings/merge-tree-settings#non_replicated_deduplication_window).

<Note>
  `insert_deduplication_token` отслеживается отдельно для каждой партиции, поэтому несколько партиций, записанных одной вставкой, могут иметь один и тот же токен. Без токена контрольная сумма содержимого по умолчанию вычисляется для всего вставляемого блока, поэтому вставка дедуплицируется только тогда, когда все её данные совпадают с данными предыдущей вставки (повторной попытки), а не когда строки одной партиции случайно совпадают со строками из другой вставки.
</Note>

Пример:

```sql theme={null}
CREATE TABLE test_table
( A Int64 )
ENGINE = MergeTree
ORDER BY A
SETTINGS non_replicated_deduplication_window = 100;

INSERT INTO test_table SETTINGS insert_deduplication_token = 'test' VALUES (1);

-- the next insert won't be deduplicated because insert_deduplication_token is different
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test1' VALUES (1);

-- the next insert will be deduplicated because insert_deduplication_token
-- is the same as one of the previous
INSERT INTO test_table SETTINGS insert_deduplication_token = 'test' VALUES (2);

SELECT * FROM test_table

┌─A─┐
│ 1 │
└───┘
┌─A─┐
│ 1 │
└───┘
```

<div id="insert_null_as_default">
  ## insert\_null\_as\_default
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

Включает или отключает вставку [значений по умолчанию](/docs/ru/reference/statements/create/table#default_values) вместо [NULL](/docs/ru/reference/syntax#null) в столбцы с типом данных, отличным от [Nullable](/docs/ru/reference/data-types/nullable).
Если тип столбца не Nullable и этот параметр отключён, вставка `NULL` вызывает исключение. Если тип столбца Nullable, значения `NULL` вставляются как есть независимо от этого параметра.

Этот параметр применим к запросам [вставка ... SELECT](/docs/ru/reference/statements/insert-into#inserting-the-results-of-select). Обратите внимание, что подзапросы `SELECT` могут быть объединены оператором `UNION ALL`.

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

* 0 — Вставка `NULL` в столбец с типом, отличным от Nullable, вызывает исключение.
* 1 — Вместо `NULL` вставляется значение столбца по умолчанию.

<div id="insert_shard_id">
  ## insert\_shard\_id
</div>

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

Если значение не равно `0`, указывает сегмент таблицы [Distributed](/docs/ru/reference/engines/table-engines/special/distributed), в который данные будут вставлены синхронно.

Если значение `insert_shard_id` некорректно, сервер сгенерирует исключение.

Чтобы узнать количество сегментов в `requested_cluster`, можно проверить конфигурацию сервера или использовать этот запрос:

```sql theme={null}
SELECT uniq(shard_num) FROM system.clusters WHERE cluster = 'requested_cluster';
```

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

* 0 — отключено.
* Любое число от `1` до `shards_num` для соответствующей таблицы [Distributed](/docs/ru/reference/engines/table-engines/special/distributed).

**Пример**

Запрос:

```sql theme={null}
CREATE TABLE x AS system.numbers ENGINE = MergeTree ORDER BY number;
CREATE TABLE x_dist AS x ENGINE = Distributed('test_cluster_two_shards_localhost', currentDatabase(), x);
INSERT INTO x_dist SELECT * FROM numbers(5) SETTINGS insert_shard_id = 1;
SELECT * FROM x_dist ORDER BY number ASC;
```

Результат:

```text theme={null}
┌─number─┐
│      0 │
│      0 │
│      1 │
│      1 │
│      2 │
│      2 │
│      3 │
│      3 │
│      4 │
│      4 │
└────────┘
```