ClickHouse/docs/en/sql-reference/statements/rename.md

---
toc_priority: 50
toc_title: RENAME
---

# RENAME Statement {#misc_operations-rename}

Renames one or more tables.

``` sql
RENAME TABLE [db11.]name11 TO [db12.]name12, [db21.]name21 TO [db22.]name22, ... [ON CLUSTER cluster]
```

Renaming tables is a light operation. If you indicated another database after `TO`, the table will be moved to this database. However, the directories with databases must reside in the same file system (otherwise, an error is returned). If you rename multiple tables in one query, this is a non-atomic operation, it may be partially executed, queries in other sessions may receive the error `Table ... doesn't exist ..`.
[docs] split misc statements (#12403) 2020-07-11 11:05:49 +00:00			`---`
			`toc_priority: 50`
Update rename.md 2020-07-23 13:05:07 +00:00			`toc_title: RENAME`
[docs] split misc statements (#12403) 2020-07-11 11:05:49 +00:00			`---`

			`# RENAME Statement {#misc_operations-rename}`

			`Renames one or more tables.`

			``` sql
			`RENAME TABLE [db11.]name11 TO [db12.]name12, [db21.]name21 TO [db22.]name22, ... [ON CLUSTER cluster]`
			```

			Renaming tables is a light operation. If you indicated another database after `TO`, the table will be moved to this database. However, the directories with databases must reside in the same file system (otherwise, an error is returned). If you rename multiple tables in one query, this is a non-atomic operation, it may be partially executed, queries in other sessions may receive the error `Table ... doesn't exist ..`.