RENAME TABLE 语句
RENAME TABLE tbl_name TO new_tbl_name [, tbl_name2 TO new_tbl_name2] ...
RENAME TABLE 语句重命名一个或多个表。对于原始表,必须具备 ALTER和 DROP 权限,对于新表,必须具备 CREATE 和 INSERT 权限。
例如,要将一个名为 old_table 的表重命名为 new_table,可使用如下语句:
RENAME TABLE old_table TO new_table;
该语句等价于下面的 ALTER TABLE 语句:
ALTER TABLE old_table RENAME new_table;
与 ALTER TABLE 不一样,RENAME TABLE 能够在一条语句中重命名多个表:
RENAME TABLE old_table1 TO new_table1, old_table2 TO new_table2, old_table3 TO new_table3;
重命名操做从左到右执行。所以,要交换两个表名,须要这样作(假设中间名称为 tmp_table 的表并不存在):
RENAME TABLE old_table TO tmp_table, new_table TO old_table, tmp_table TO new_table;
表上的元数据锁是按名称顺序得到的,在某些状况下,当多个事务并发执行时,这会影响操做的结果。
从 MySQL 8.0.13 开始,能够重命名使用 LOCK TABLES 语句锁定的表,前提是这些表是用 WRITE 锁锁定的,或者是在以前的多表重命名操做中重命名 WRITE 锁表的结果。例如,容许这样作:
LOCK TABLE old_table1 WRITE;RENAME TABLE old_table1 TO new_table1, new_table1 TO new_table2;
这是不容许的:
LOCK TABLE old_table1 READ;RENAME TABLE old_table1 TO new_table1, new_table1 TO new_table2;
在 MySQL 8.0.13 以前,要执行 RENAME TABLE 语句,必须没有用 LOCK TABLES 语句锁定的表。
在知足事务表锁定条件后,重命名操做将自动完成;在重命名过程当中,其余会话不能访问这些表。
若是在 RENAME TABLE 语句执行期间出现任何错误,则该语句将失败,而且不会进行任何更改。
可使用 RENAME TABLE 语句将表从一个数据库移动到另外一个数据库:
RENAME TABLE current_db.tbl_name TO other_db.tbl_name;
使用此方法将全部表从一个数据库移动到另外一个数据库,实际上至关于重命名数据库(MySQL对该操做没有单独的语句),区别是原始数据库仍然存在,尽管库里面已经没有表了。
相似于 RENAME TABLE, ALTER TABLE ... RENAME 也能够用于将表移动到另外一个数据库。无论使用哪一个语句,若是重命名操做将表移动到位于不一样文件系统上的数据库中,结果的成功与否取决于平台,以及用于移动表文件的底层操做系统调用。
若是表有触发器,尝试将表重命名到另外一个数据库将会失败,报错信息为:Trigger in wrong schema (ER_TRG_IN_WRONG_SCHEMA)。
能够将未加密的表移动到支持加密的数据库中,反之亦然。可是,若是启用了 table_encryption_privilege_check 变量,若是表加密设置与默认的数据库加密不一样,则须要 TABLE_ENCRYPTION_ADMIN 权限。
要重命名临时表,RENAME TABLE 命令无效。请使用 ALTER TABLE 代替。
RENAME TABLE 命令适用于视图,但视图不能重命名到另外一个数据库。
专门为重命名的表或视图授予的任何权限都不会迁移到新名称,必须手动更改。
RENAME TABLE tbl_name TO new_tbl_name 更改以字符串“tbl_name_ibfk_” 开头的内部生成的外键约束名称和用户定义的外键约束名称,以反映出新的表名。InnoDB 将以字符串 “tbl_name_ibfk_” 开头的外键约束名称识别为内部生成的名称。
指向重命名表的外键约束名称将自动更新,除非存在冲突,在这种状况下,语句失败并出现错误。若是重命名的约束名称已经存在,则会发生冲突。在这种状况下,必须删除并从新建立外键,以便它们正常工做。
RENAME TABLE tbl_name TO new_tbl_name 语句更改以字符串“tbl_name_chk_” 开头的内部生成和用户定义的 CHECK 约束名称,以反映新的表名。MySQL 将以字符串 “tbl_name_chk_” 开头的 CHECK 约束名称识别为内部生成的名称。例子:
mysql> SHOW CREATE TABLE t1\G*************************** 1. row *************************** Table: t1Create Table: CREATE TABLE `t1` ( `i1` int(11) DEFAULT NULL, `i2` int(11) DEFAULT NULL, CONSTRAINT `t1_chk_1` CHECK ((`i1` > 0)), CONSTRAINT `t1_chk_2` CHECK ((`i2` < 0))) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci1 row in set (0.02 sec)
mysql> RENAME TABLE t1 TO t3;Query OK, 0 rows affected (0.03 sec)
mysql> SHOW CREATE TABLE t3\G*************************** 1. row *************************** Table: t3Create Table: CREATE TABLE `t3` ( `i1` int(11) DEFAULT NULL, `i2` int(11) DEFAULT NULL, CONSTRAINT `t3_chk_1` CHECK ((`i1` > 0)), CONSTRAINT `t3_chk_2` CHECK ((`i2` < 0))) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci1 row in set (0.01 sec)