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

---
toc_priority: 48
toc_title: RENAME
---

# RENAME Statement {#misc_operations-rename}

## RENAME DATABASE {#misc_operations-rename_database}
Renames database, it is supported only for Atomic database engine.

```
RENAME DATABASE atomic_database1 TO atomic_database2 [ON CLUSTER cluster]
```

## RENAME TABLE {#misc_operations-rename_table}
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 ... does not exist ..`.
[docs] split misc statements (#12403) 2020-07-11 11:05:49 +00:00			`---`
DOCSUP-2806: Add meta header in RU (#15801) * DOCSUP-2806: Add meta intro. * DOCSUP-2806: Update meta intro. * DOCSUP-2806: Fix meta. * DOCSUP-2806: Add quotes for meta headers. * DOCSUP-2806: Remove quotes from meta headers. * DOCSUP-2806: Add meta headers. * DOCSUP-2806: Fix quotes in meta headers. * DOCSUP-2806: Update meta headers. * DOCSUP-2806: Fix link to nowhere in EN. * DOCSUP-2806: Fix link (settings to tune) * DOCSUP-2806: Fix links. * DOCSUP-2806:Fix links EN * DOCSUP-2806: Fix build errors. * DOCSUP-2806: Fix meta intro. * DOCSUP-2806: Fix toc_priority in examples datasets TOC. * DOCSUP-2806: Fix items order in toc. * DOCSUP-2806: Fix order in toc. * DOCSUP-2806: Fix toc order. * DOCSUP-2806: Fix order in toc. * DOCSUP-2806: Fix toc index in create * DOCSUP-2806: Fix toc order in create. Co-authored-by: romanzhukov <romanzhukov@yandex-team.ru> Co-authored-by: alexey-milovidov <milovidov@yandex-team.ru> 2020-10-26 10:29:30 +00:00			`toc_priority: 48`
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}`

add RENAME DATABASE statement documentation 2021-04-09 11:21:09 +00:00			`## RENAME DATABASE {#misc_operations-rename_database}`
Edit and translate to Russian 2021-05-26 12:38:54 +00:00			`Renames database, it is supported only for Atomic database engine.`
add RENAME DATABASE statement documentation 2021-04-09 11:21:09 +00:00
			```
			`RENAME DATABASE atomic_database1 TO atomic_database2 [ON CLUSTER cluster]`
			```

			`## RENAME TABLE {#misc_operations-rename_table}`
[docs] split misc statements (#12403) 2020-07-11 11:05:49 +00:00			`Renames one or more tables.`

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

Avoid short syntax 2021-05-27 19:44:11 +00:00			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 ... does not exist ..`.