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

> 자동 생성된 distributed_ddl_* 그룹의 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_ddl_entry_format_version">
  ## distributed\_ddl\_entry\_format\_version
</div>

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

분산 DDL (ON CLUSTER) 쿼리의 호환 버전

Cloud 기본값: `6`.

<div id="distributed_ddl_output_mode">
  ## distributed\_ddl\_output\_mode
</div>

<SettingsInfoBlock type="DistributedDDLOutputMode" default_value="throw" />

분산 DDL 쿼리 결과의 포맷을 설정합니다.

가능한 값:

* `throw` — 쿼리가 완료된 모든 호스트의 쿼리 실행 상태가 포함된 결과 집합(result set)을 반환합니다. 일부 호스트에서 쿼리가 실패한 경우 첫 번째 Exception을 다시 발생시킵니다. 일부 호스트에서 아직 쿼리가 완료되지 않았고 [distributed\_ddl\_task\_timeout](/docs/ko/reference/settings/session-settings/distributed-ddl#distributed_ddl_task_timeout)을 초과한 경우 `TIMEOUT_EXCEEDED` Exception을 발생시킵니다.
* `none` — `throw`와 비슷하지만, 분산 DDL 쿼리는 결과 집합을 반환하지 않습니다.
* `null_status_on_timeout` — 해당 호스트에서 쿼리가 아직 완료되지 않은 경우 `TIMEOUT_EXCEEDED`를 발생시키는 대신, 결과 집합의 일부 행에서 실행 상태로 `NULL`을 반환합니다.
* `never_throw` — 일부 호스트에서 쿼리가 실패하더라도 `TIMEOUT_EXCEEDED`를 발생시키지 않으며 Exception도 다시 발생시키지 않습니다.
* `none_only_active` - `none`과 비슷하지만 `Replicated` 데이터베이스의 비활성 레플리카는 기다리지 않습니다. 참고: 이 모드에서는 일부 레플리카에서 쿼리가 실행되지 않았고 백그라운드에서 실행될 예정인지 확인할 수 없습니다.
* `null_status_on_timeout_only_active` — `null_status_on_timeout`과 비슷하지만 `Replicated` 데이터베이스의 비활성 레플리카는 기다리지 않습니다.
* `throw_only_active` — `throw`와 비슷하지만 `Replicated` 데이터베이스의 비활성 레플리카는 기다리지 않습니다.

Cloud 기본값: `none_only_active`.

<div id="distributed_ddl_task_timeout">
  ## distributed\_ddl\_task\_timeout
</div>

<SettingsInfoBlock type="Int64" default_value="180" />

클러스터의 모든 호스트에서 DDL 쿼리 응답을 기다리는 timeout을 설정합니다. DDL request가 모든 호스트에서 수행되지 않으면, 응답에 timeout 오류가 포함되며 request는 async 모드로 실행됩니다. 음수 값은 무한대를 의미합니다.

가능한 값:

* 양의 정수.
* 0 — Async 모드.
* 음의 정수 — 무한 timeout.