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

# configurações de sessão de distributed_ddl_*

> Configurações de sessão do ClickHouse no grupo gerado distributed_ddl_*.

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
  }}>Tipo</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Padrão</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Pode ser alterado sem reiniciar
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Essas configurações estão disponíveis em [system.settings](/docs/pt-BR/reference/system-tables/settings) e são geradas automaticamente com base no [código-fonte](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" />

Versão de compatibilidade para consultas de DDL distribuído (ON CLUSTER)

Valor padrão no Cloud: `6`.

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

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

Define o formato do resultado da consulta de DDL distribuído.

Valores possíveis:

* `throw` — Retorna o conjunto de resultados com o status de execução da consulta para todos os hosts em que a consulta foi concluída. Se a consulta falhar em alguns hosts, a primeira exceção será relançada. Se a consulta ainda não tiver sido concluída em alguns hosts e [distributed\_ddl\_task\_timeout](/docs/pt-BR/reference/settings/session-settings/distributed-ddl#distributed_ddl_task_timeout) for excedido, será lançada a exceção `TIMEOUT_EXCEEDED`.
* `none` — Semelhante a `throw`, mas a consulta de DDL distribuído não retorna conjunto de resultados.
* `null_status_on_timeout` — Retorna `NULL` como status de execução em algumas linhas do conjunto de resultados, em vez de lançar `TIMEOUT_EXCEEDED`, se a consulta não tiver sido concluída nos hosts correspondentes.
* `never_throw` — Não lança `TIMEOUT_EXCEEDED` nem relança exceções se a consulta falhar em alguns hosts.
* `none_only_active` - semelhante a `none`, mas não espera por réplicas inativas do banco de dados `Replicated`. Observação: com esse modo, é impossível saber que a consulta não foi executada em alguma réplica e será executada em segundo plano.
* `null_status_on_timeout_only_active` — semelhante a `null_status_on_timeout`, mas não espera por réplicas inativas do banco de dados `Replicated`
* `throw_only_active` — semelhante a `throw`, mas não espera por réplicas inativas do banco de dados `Replicated`

Valor padrão no Cloud: `none_only_active`.

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

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

Define o timeout para as respostas de consultas DDL de todos os hosts do cluster. Se uma solicitação DDL não tiver sido executada em todos os hosts, a resposta conterá um erro de timeout, e a solicitação será executada em modo async. Um valor negativo significa timeout infinito.

Valores possíveis:

* Inteiro positivo.
* 0 — Modo async.
* Inteiro negativo — timeout infinito.