Instruction RENAME

Documentation de l’instruction RENAME

Renomme des bases de données, des tables ou des dictionnaires. Plusieurs entités peuvent être renommées dans une même requête. Notez qu’une requête RENAME portant sur plusieurs entités n’est pas atomique. Pour permuter les noms des entités de manière atomique, utilisez l’instruction EXCHANGE.

Syntaxe

RENAME [DATABASE|TABLE|DICTIONARY] name TO new_name [,...] [ON CLUSTER cluster]

​

RENAME DATABASE

Renomme des bases de données.

Syntaxe

RENAME DATABASE atomic_database1 TO atomic_database2 [,...] [ON CLUSTER cluster]

​

RENAME TABLE

Renomme une ou plusieurs tables.

Le renommage de tables est une opération légère. Si vous indiquez une base de données différente après TO, la table sera déplacée vers cette base de données. Cependant, les répertoires des bases de données doivent se trouver sur le même système de fichiers. Sinon, une erreur est renvoyée. Si vous renommez plusieurs tables dans une seule requête, l’opération n’est pas atomique. Elle peut être exécutée partiellement, et les requêtes d’autres sessions peuvent renvoyer l’erreur Table ... does not exist ....

Syntaxe

RENAME TABLE [db1.]name1 TO [db2.]name2 [,...] [ON CLUSTER cluster]

Exemple

RENAME TABLE table_A TO table_A_bak, table_B TO table_B_bak;

Vous pouvez également utiliser une requête SQL plus simple :

RENAME table_A TO table_A_bak, table_B TO table_B_bak;

​

RENAME DICTIONARY

Renomme un ou plusieurs dictionnaires. Cette requête permet de déplacer des dictionnaires entre des bases de données.

Syntaxe

RENAME DICTIONARY [db0.]dict_A TO [db1.]dict_B [,...] [ON CLUSTER cluster]

Voir aussi

• Dictionnaires