MySQL的SQL语句 - 数据定义语句（18）- RENAME TABLE 语句

林员外聊编程 2020-09-01

157

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: t1
Create 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_ci
1 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: t3
Create 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_ci
1 row in set (0.01 sec)
复制

官方文档：

https://dev.mysql.com/doc/refman/8.0/en/rename-table.html

mysql

文章转载自林员外聊编程，如果涉嫌侵权，请发送邮件至：contact@modb.pro进行举报，并提供相关证据，一经查实，墨天轮将立刻删除相关内容。

MySQL的SQL语句 - 数据定义语句（18）- RENAME TABLE 语句

评论

相关阅读