ClickHouse/docs/en/sql-reference/distributed-ddl.md

---
slug: /en/sql-reference/distributed-ddl
sidebar_position: 3
sidebar_label: Distributed DDL
---

# Distributed DDL Queries (ON CLUSTER Clause)

By default the `CREATE`, `DROP`, `ALTER`, and `RENAME` queries affect only the current server where they are executed. In a cluster setup, it is possible to run such queries in a distributed manner with the `ON CLUSTER` clause.

For example, the following query creates the `all_hits` `Distributed` table on each host in `cluster`:

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

In order to run these queries correctly, each host must have the same cluster definition (to simplify syncing configs, you can use substitutions from ZooKeeper). They must also connect to the ZooKeeper servers.

The local version of the query will eventually be executed on each host in the cluster, even if some hosts are currently not available.

:::important    
The order for executing queries within a single host is guaranteed.
:::
[docs] split various kinds of CREATE queries into separate articles (#12328) * normalize * split & adjust links * re-normalize * adjust ru links * adjust ja/tr links * partially apply e0d19d2aeaeafa3620305bce3a991fefc0e28695 * reset contribs 2020-07-09 15:10:35 +00:00			`---`
add slugs 2022-08-28 14:53:34 +00:00			`slug: /en/sql-reference/distributed-ddl`
Added reference docs to sidebar 2022-04-11 03:27:48 +00:00			`sidebar_position: 3`
Removed /ja folder, cleaned up /ru markdown 2022-04-09 13:29:05 +00:00			`sidebar_label: Distributed DDL`
[docs] split various kinds of CREATE queries into separate articles (#12328) * normalize * split & adjust links * re-normalize * adjust ru links * adjust ja/tr links * partially apply e0d19d2aeaeafa3620305bce3a991fefc0e28695 * reset contribs 2020-07-09 15:10:35 +00:00			`---`

Remove H1 anchor tags from docs 2022-06-02 10:55:18 +00:00			`# Distributed DDL Queries (ON CLUSTER Clause)`
[docs] split various kinds of CREATE queries into separate articles (#12328) * normalize * split & adjust links * re-normalize * adjust ru links * adjust ja/tr links * partially apply e0d19d2aeaeafa3620305bce3a991fefc0e28695 * reset contribs 2020-07-09 15:10:35 +00:00
			By default the `CREATE`, `DROP`, `ALTER`, and `RENAME` queries affect only the current server where they are executed. In a cluster setup, it is possible to run such queries in a distributed manner with the `ON CLUSTER` clause.

			For example, the following query creates the `all_hits` `Distributed` table on each host in `cluster`:

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

			`In order to run these queries correctly, each host must have the same cluster definition (to simplify syncing configs, you can use substitutions from ZooKeeper). They must also connect to the ZooKeeper servers.`

			`The local version of the query will eventually be executed on each host in the cluster, even if some hosts are currently not available.`

standardize admonitions 2023-03-27 18:54:05 +00:00			`:::important`
Removed /ja folder, cleaned up /ru markdown 2022-04-09 13:29:05 +00:00			`The order for executing queries within a single host is guaranteed.`
standardize admonitions 2023-03-27 18:54:05 +00:00			`:::`