Переименовывает базы данных, таблицы или словари. За один запрос можно переименовать несколько сущностей.
Обратите внимание, что запрос RENAME с несколькими сущностями не является атомарной операцией. Чтобы атомарно поменять имена сущностей местами, используйте оператор EXCHANGE.
Синтаксис
RENAME [DATABASE|TABLE|DICTIONARY] name TO new_name [,...] [ON CLUSTER cluster]
Переименовывает базы данных.
Синтаксис
RENAME DATABASE atomic_database1 TO atomic_database2 [,...] [ON CLUSTER cluster]
Переименовывает одну или несколько таблиц.
Переименование таблиц — лёгкая операция. Если после TO указать другую базу данных, таблица будет перемещена в неё. Однако каталоги баз данных должны находиться в одной и той же файловой системе. В противном случае будет возвращена ошибка.
Если переименовывать несколько таблиц в одном запросе, операция не является атомарной. Она может быть выполнена частично, и запросы в других сеансах могут привести к ошибке Table ... does not exist ....
Синтаксис
RENAME TABLE [db1.]name1 TO [db2.]name2 [,...] [ON CLUSTER cluster]
Пример
RENAME TABLE table_A TO table_A_bak, table_B TO table_B_bak;
Или можно использовать более простой SQL:
RENAME table_A TO table_A_bak, table_B TO table_B_bak;
Переименовывает один или несколько словарей. Этот запрос также можно использовать для перемещения словарей между базами данных.
Синтаксис
RENAME DICTIONARY [db0.]dict_A TO [db1.]dict_B [,...] [ON CLUSTER cluster]
См. также
Последнее изменение 10 июня 2026 г.