Перейти к основному содержанию
Переименовывает базы данных, таблицы или словари. За один запрос можно переименовать несколько сущностей. Обратите внимание, что запрос RENAME с несколькими сущностями не является атомарной операцией. Чтобы атомарно поменять имена сущностей местами, используйте оператор EXCHANGE. Синтаксис
RENAME [DATABASE|TABLE|DICTIONARY] name TO new_name [,...] [ON CLUSTER cluster]

RENAME DATABASE

Переименовывает базы данных. Синтаксис
RENAME DATABASE atomic_database1 TO atomic_database2 [,...] [ON CLUSTER cluster]

RENAME TABLE

Переименовывает одну или несколько таблиц. Переименование таблиц — лёгкая операция. Если после 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

Переименовывает один или несколько словарей. Этот запрос также можно использовать для перемещения словарей между базами данных. Синтаксис
RENAME DICTIONARY [db0.]dict_A TO [db1.]dict_B [,...] [ON CLUSTER cluster]
См. также
Последнее изменение 10 июня 2026 г.