Instrução RENAME

Documentação da 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.

Sintaxe

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

​

RENAME DATABASE

Renomeia bancos de dados.

Sintaxe

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

​

RENAME TABLE

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

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

Exemplo

RENAME TABLE table_A TO table_A_bak, table_B TO table_B_bak;

E você pode usar um SQL mais simples:

RENAME table_A TO table_A_bak, table_B TO table_B_bak;

​

RENAME DICTIONARY

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

Sintaxe

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

Veja também

• Dicionários