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

> Documentação da instrução RENAME

# Instrução RENAME

Renomeia bancos de dados, tabelas ou dicionários. Várias entidades podem ser renomeadas em uma única consulta.
Observe que a instrução `RENAME` com várias entidades é uma operação não atômica. Para trocar os nomes das entidades de forma atômica, use a instrução [EXCHANGE](/pt-BR/reference/statements/exchange).

**Sintaxe**

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

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

Renomeia bancos de dados.

**Sintaxe**

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

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

Renomeia uma ou mais tabelas.

Renomear tabelas é uma operação leve. Se você especificar um banco de dados diferente após `TO`, a tabela será movida para esse banco de dados. No entanto, os diretórios dos bancos de dados devem estar no mesmo sistema de arquivos. Caso contrário, será retornado um erro.
Se você renomear várias tabelas em uma consulta, a operação não será atômica. Ela pode ser executada parcialmente, e consultas em outras sessões podem receber o erro `Table ... does not exist ...`.

**Sintaxe**

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

**Exemplo**

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

E você pode usar um SQL mais simples:

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

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

Renomeia um ou mais dicionários. Esta consulta pode ser usada para mover dicionários entre bancos de dados.

**Sintaxe**

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

**Veja também**

* [Dicionários](/pt-BR/reference/statements/create/dictionary)