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

# deduplicate_insert_* 会话设置

> ClickHouse 在 deduplicate_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/zh/reference/system-tables/settings) 中查看，并由 [源文件](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) 自动生成。

<div id="deduplicate_insert">
  ## deduplicate\_insert
</div>

<SettingsInfoBlock type="DeduplicateInsertMode" default_value="enable" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.2"},{"label": "enable"},{"label": "默认对所有同步和异步插入启用去重。"}]}]} />

启用或禁用 `INSERT INTO` 的块级去重 (用于 Replicated\* 表) 。
此设置会覆盖 `insert_deduplicate` 和 `async_insert_deduplicate` 设置。
该设置有三个可能值：

* disable — 对 `INSERT INTO` 查询禁用去重。
* enable — 对 `INSERT INTO` 查询启用去重。
* backward\_compatible\_choice — 如果针对特定插入类型启用了 `insert_deduplicate` 或 `async_insert_deduplicate`，则启用去重。

<div id="deduplicate_insert_select">
  ## deduplicate\_insert\_select
</div>

<SettingsInfoBlock type="DeduplicateInsertSelectMode" default_value="enable_when_possible" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "enable_when_possible"},{"label": "将 deduplicate_insert_select 的默认行为改为 ENABLE_WHEN_POSSIBLE"}]}, {"id": "row-2","items": [{"label": "enable_even_for_bad_queries"},{"label": "新设置，替换 insert_select_deduplicate"}]}]} />

启用或禁用 `INSERT SELECT` 的块级去重 (适用于 Replicated\* 表) 。
对于 `INSERT SELECT` 查询，此设置会覆盖 `insert_deduplicate` 和 `deduplicate_insert`。
该设置有四个可能值：

* disable — 对 `INSERT SELECT` 查询禁用去重。
* force\_enable — 对 `INSERT SELECT` 查询启用去重。如果 SELECT 结果不稳定，则会抛出异常。
* enable\_when\_possible — 如果 `insert_deduplicate` 已启用且 SELECT 结果稳定，则启用去重；否则禁用。
* enable\_even\_for\_bad\_queries - 如果 `insert_deduplicate` 已启用，则启用去重。如果 SELECT 结果不稳定，则会记录警告，但查询仍会在启用去重的情况下执行。此选项用于向后兼容。建议改用其他选项，因为它可能导致意外结果。
