RENAME ステートメント

RENAME ステートメントのリファレンス

データベース、テーブル、またはDictionaryの名前を変更します。1つのクエリで複数のエンティティの名前を変更できます。 複数のエンティティを含む 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

1 つ以上のテーブルの名前を変更します。

テーブル名の変更は軽量な操作です。TO の後に別のデータベースを指定すると、テーブルはそのデータベースに移動されます。ただし、データベースのディレクトリは同じファイルシステム上に存在している必要があります。そうでない場合は、エラーが返されます。 1 つのクエリで複数のテーブルの名前を変更する場合、この操作はアトミックではありません。部分的に実行される可能性があり、他のセッションのクエリで 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

1 つまたは複数の Dictionary の名前を変更します。このクエリを使用すると、Dictionary をデータベース間で移動できます。

構文

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

関連項目

• Dictionaries