> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentação sobre DDL distribuído

# Consultas de DDL distribuído (cláusula ON CLUSTER)

Por padrão, as consultas `CREATE`, `DROP`, `ALTER` e `RENAME` afetam apenas o servidor atual em que são executadas. Em uma configuração de cluster, é possível executar essas consultas de forma distribuída usando a cláusula `ON CLUSTER`.

Por exemplo, a consulta a seguir cria a tabela `all_hits` `Distributed` em cada host do `cluster`:

```sql theme={null}
CREATE TABLE IF NOT EXISTS all_hits ON CLUSTER cluster (p Date, i Int32) ENGINE = Distributed(cluster, default, hits)
```

Para que essas consultas sejam executadas corretamente, cada host deve ter a mesma definição de cluster (para simplificar a sincronização das configurações, você pode usar substituições do ZooKeeper). Além disso, cada host deve se conectar aos servidores do ZooKeeper.

A versão local da consulta será executada em cada host do cluster, mesmo que alguns hosts não estejam disponíveis no momento.

<Warning>
  A ordem de execução das consultas em um único host é garantida.
</Warning>