> ## 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_quorum_* 세션 설정

> insert_quorum_* 생성 그룹에 속한 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="insert_quorum">
  ## insert\_quorum
</div>

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

<Note>
  이 설정은 SharedMergeTree에는 적용되지 않습니다. 자세한 내용은 [SharedMergeTree 일관성](/docs/ko/products/cloud/features/infrastructure/shared-merge-tree#consistency)을 참조하십시오.
</Note>

쿼럼 쓰기를 활성화합니다.

* `insert_quorum < 2`이면 쿼럼 쓰기가 비활성화됩니다.
* `insert_quorum >= 2`이면 쿼럼 쓰기가 활성화됩니다.
* `insert_quorum = 'auto'`이면 과반수(`number_of_replicas / 2 + 1`)를 쿼럼 수로 사용합니다.

쿼럼 쓰기

`INSERT`는 ClickHouse가 `insert_quorum_timeout` 내에 `insert_quorum`개의 레플리카에 데이터를 정상적으로 기록한 경우에만 성공합니다. 어떤 이유로든 쓰기에 성공한 레플리카 수가 `insert_quorum`에 도달하지 못하면 해당 쓰기는 실패로 간주되며, ClickHouse는 이미 데이터가 기록된 모든 레플리카에서 삽입된 블록을 삭제합니다.

`insert_quorum_parallel`이 비활성화되어 있으면 쿼럼에 속한 모든 레플리카는 일관된 상태가 됩니다. 즉, 이전의 모든 `INSERT` 쿼리 데이터를 포함합니다(`INSERT` 시퀀스가 선형화됨). `insert_quorum`으로 기록된 데이터를 읽을 때 `insert_quorum_parallel`이 비활성화되어 있다면, [select\_sequential\_consistency](/docs/ko/reference/settings/session-settings/other#select_sequential_consistency)를 사용해 `SELECT` 쿼리에서 순차 일관성을 활성화할 수 있습니다.

ClickHouse는 다음 경우 예외를 발생시킵니다.

* 쿼리 시점에 사용 가능한 레플리카 수가 `insert_quorum`보다 적은 경우
* `insert_quorum_parallel`이 비활성화된 상태에서 이전 블록이 아직 `insert_quorum`개의 레플리카에 삽입되지 않았는데 데이터를 쓰려고 하는 경우. 이 상황은 사용자가 이전 `insert_quorum`이 완료되기 전에 동일한 테이블에 대해 다른 `INSERT` 쿼리를 수행하려고 할 때 발생할 수 있습니다.

관련 항목:

* [insert\_quorum\_timeout](/docs/ko/reference/settings/session-settings/insert-quorum#insert_quorum_timeout)
* [insert\_quorum\_parallel](/docs/ko/reference/settings/session-settings/insert-quorum#insert_quorum_parallel)
* [select\_sequential\_consistency](/docs/ko/reference/settings/session-settings/other#select_sequential_consistency)

<div id="insert_quorum_parallel">
  ## insert\_quorum\_parallel
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "21.1"},{"label": "1"},{"label": "기본적으로 병렬 쿼럼 삽입을 사용합니다. 순차 쿼럼 삽입보다 훨씬 편리합니다"}]}]} />

<Note>
  이 설정은 SharedMergeTree에는 적용되지 않습니다. 자세한 내용은 [SharedMergeTree 일관성](/docs/ko/products/cloud/features/infrastructure/shared-merge-tree#consistency)을 참조하십시오.
</Note>

쿼럼 `INSERT` 쿼리의 병렬 실행을 활성화하거나 비활성화합니다. 활성화하면 이전 쿼리가 아직 완료되지 않았더라도 추가 `INSERT` 쿼리를 전송할 수 있습니다. 비활성화하면 동일한 테이블에 대한 추가 쓰기 작업이 거부됩니다.

가능한 값:

* 0 — 비활성화됨.
* 1 — 활성화됨.

관련 항목:

* [insert\_quorum](/docs/ko/reference/settings/session-settings/insert-quorum#insert_quorum)
* [insert\_quorum\_timeout](/docs/ko/reference/settings/session-settings/insert-quorum#insert_quorum_timeout)
* [select\_sequential\_consistency](/docs/ko/reference/settings/session-settings/other#select_sequential_consistency)

<div id="insert_quorum_timeout">
  ## insert\_quorum\_timeout
</div>

<SettingsInfoBlock type="Milliseconds" default_value="600000" />

쿼럼에 대한 쓰기 시간 제한으로, 단위는 밀리초입니다. 제한 시간이 경과할 때까지 아직 쓰기가 수행되지 않으면 ClickHouse가 예외를 발생시키며, 클라이언트는 동일한 블록을 동일한 레플리카 또는 다른 레플리카에 쓰기 위해 쿼리를 다시 실행해야 합니다.

관련 항목:

* [insert\_quorum](/docs/ko/reference/settings/session-settings/insert-quorum#insert_quorum)
* [insert\_quorum\_parallel](/docs/ko/reference/settings/session-settings/insert-quorum#insert_quorum_parallel)
* [select\_sequential\_consistency](/docs/ko/reference/settings/session-settings/other#select_sequential_consistency)