RENAME TABLE

説明

このステートメントは、1つまたは複数のテーブルをリネームするために使用されます。

制限事項と注意点

• テーブルのリネーム処理中、システムは自動的にこの処理をロックし、リネームが完了するまで他のスレッドによるこれらのテーブルへの読み取り操作をブロックします。

• ターゲットテーブルに継続的なアクティブトランザクションが存在する場合、リネーム操作は待機します。すべてのアクティブトランザクションがコミットまたはロールバックされるまで、テーブルのリネーム処理は進行できません。

• このステートメントが複数のテーブルのリネームに使用される場合、リネーム操作は左から右へと順番に実行されます。

• RENAME TABLE を実行する際には、ロックされたテーブルやアクティブな状態のトランザクションがあってはなりません。

  説明

  テナントレベルの構成パラメータ enable_lock_priority を有効にすると、RENAME TABLE は最も高いロック優先順位を持ちます。

• RENAME TABLE はビューに対して使用できますが、他のデータベースへの移動はサポートされていません。

• RENAME TABLE 操作中、テーブルのロックおよび読み書き防御策が追加されるため、操作時間が長くなります。他のユーザーによるDDL操作への影響を避けるため、一括して RENAME TABLE 操作を実行することは推奨されません。

権限要件

この操作には、元のテーブルに対する ALTER および DROP 権限と、新しいテーブルに対する CREATE および INSERT 権限が必要です。

構文

RENAME TABLE table_name TO [new_database_name.]new_table_name
   [, table_name2 TO [new_database_name.]new_table_name2 ...];

パラメータの説明

例

1. テーブル t1 と t2 を作成します。

   obclient> CREATE TABLE t1(c1 INT);
   obclient> CREATE TABLE t2(c1 INT);
   

2. テーブル t1 の名前を t11 に変更します。

   obclient> RENAME TABLE t1 TO t11;
   

3. テーブル t11 の名前を t111 に、テーブル t2 の名前を t22 に変更します。

   obclient> RENAME TABLE t11 TO t111, t2 TO t22;
   

4. テーブル t22 を mysql データベースに移動します。

   obclient> RENAME TABLE t22 TO mysql.t22;