> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentation de l’instruction RENAME

# 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](/fr/reference/statements/exchange).

**Syntaxe**

```sql theme={null}
RENAME [DATABASE|TABLE|DICTIONARY] name TO new_name [,...] [ON CLUSTER cluster]
```

<div id="rename-database">
  ## RENAME DATABASE
</div>

Renomme des bases de données.

**Syntaxe**

```sql theme={null}
RENAME DATABASE atomic_database1 TO atomic_database2 [,...] [ON CLUSTER cluster]
```

<div id="rename-table">
  ## RENAME TABLE
</div>

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**

```sql theme={null}
RENAME TABLE [db1.]name1 TO [db2.]name2 [,...] [ON CLUSTER cluster]
```

**Exemple**

```sql theme={null}
RENAME TABLE table_A TO table_A_bak, table_B TO table_B_bak;
```

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

```sql theme={null}
RENAME table_A TO table_A_bak, table_B TO table_B_bak;
```

<div id="rename-dictionary">
  ## RENAME DICTIONARY
</div>

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

**Syntaxe**

```sql theme={null}
RENAME DICTIONARY [db0.]dict_A TO [db1.]dict_B [,...] [ON CLUSTER cluster]
```

**Voir aussi**

* [Dictionnaires](/fr/reference/statements/create/dictionary)