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

# distributed_replica_* 세션 설정

> distributed_replica_* 생성 그룹의 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="distributed_replica_error_cap">
  ## distributed\_replica\_error\_cap
</div>

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

* 유형: 부호 없는 정수
* 기본값: 1000

각 레플리카의 오류 수는 이 값까지만 누적되므로, 하나의 레플리카에 오류가 과도하게 쌓이는 것을 방지합니다.

관련 항목:

* [load\_balancing](/docs/ko/reference/settings/session-settings/load-balancing#load_balancing-round_robin)
* [분산 테이블 엔진](/docs/ko/reference/engines/table-engines/special/distributed)
* [distributed\_replica\_error\_half\_life](/docs/ko/reference/settings/session-settings/distributed-replica#distributed_replica_error_half_life)
* [distributed\_replica\_max\_ignored\_errors](/docs/ko/reference/settings/session-settings/distributed-replica#distributed_replica_max_ignored_errors)

<div id="distributed_replica_error_half_life">
  ## distributed\_replica\_error\_half\_life
</div>

<SettingsInfoBlock type="Seconds" default_value="60" />

* 유형: 초
* 기본값: 60초

분산 테이블에서 오류 수치가 얼마나 빠르게 0으로 감소하는지를 제어합니다. 레플리카를 일정 시간 동안 사용할 수 없어 오류가 5개 누적되었고 distributed\_replica\_error\_half\_life가 1초로 설정된 경우, 마지막 오류가 발생한 후 3초가 지나면 해당 레플리카는 정상으로 간주됩니다.

관련 항목:

* [load\_balancing](/docs/ko/reference/settings/session-settings/load-balancing#load_balancing-round_robin)
* [분산 테이블 엔진](/docs/ko/reference/engines/table-engines/special/distributed)
* [distributed\_replica\_error\_cap](/docs/ko/reference/settings/session-settings/distributed-replica#distributed_replica_error_cap)
* [distributed\_replica\_max\_ignored\_errors](/docs/ko/reference/settings/session-settings/distributed-replica#distributed_replica_max_ignored_errors)

<div id="distributed_replica_max_ignored_errors">
  ## distributed\_replica\_max\_ignored\_errors
</div>

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

* 유형: 부호 없는 정수
* 기본값: 0

레플리카를 선택할 때(`load_balancing` 알고리즘에 따라) 무시할 오류 수입니다.

관련 항목:

* [load\_balancing](/docs/ko/reference/settings/session-settings/load-balancing#load_balancing-round_robin)
* [분산 테이블 엔진](/docs/ko/reference/engines/table-engines/special/distributed)
* [distributed\_replica\_error\_cap](/docs/ko/reference/settings/session-settings/distributed-replica#distributed_replica_error_cap)
* [distributed\_replica\_error\_half\_life](/docs/ko/reference/settings/session-settings/distributed-replica#distributed_replica_error_half_life)