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

> Documentação sobre DDL distribuído

# Página sobre DDL distribuído

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 com a cláusula `ON CLUSTER`.

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

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

Para executar essas consultas 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). Todos eles também devem se conectar aos servidores ZooKeeper.

A versão local da consulta acabará sendo 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>
