MySQL RENAME TABLE 必须显式指定完整库名,不支持省略;跨库重命名要求目标库存在,目标表不能已存在;不支持变量、会锁表、受外键约束限制、不复制数据、不影响已有连接。

RENAME TABLE 语法必须用完整库名
MySQL 的 RENAME TABLE 不支持只写表名,哪怕当前已执行 USE db_name。省略库名会直接报错 ERROR 1064 (42000),提示语法错误。
正确写法必须显式带上数据库名(或使用反引号包裹):
RENAME TABLE old_db.old_table TO new_db.new_table;
如果只是同库重命名,也要写成:
RENAME TABLE mydb.users TO mydb.users_new;
- 跨库重命名时,目标库必须已存在,否则报错
ERROR 1049 (42000): Unknown database - 目标表名不能已存在,否则报错
ERROR 1050 (42S01): Table already exists - 不支持用变量或拼接字符串,SQL 中无法动态替换表名
重命名期间表会被短暂锁住
RENAME TABLE 在大多数存储引擎(如 InnoDB)中是原子操作,但底层仍需获取两个表的排他元数据锁(MDL)。这意味着:在执行瞬间,对原表和目标表的 DDL、DML 都会被阻塞,直到重命名完成。
尤其要注意长事务的影响——如果此时有未提交的事务正在查 old_table,RENAME TABLE 会一直等待,可能拖慢整个操作。
- 生产环境建议在低峰期执行,避免卡住业务查询
- 可通过
SELECT * FROM performance_schema.threads WHERE PROCESSLIST_INFO LIKE '%RENAME%';观察是否被阻塞 - 不要在重命名前后紧挨着执行
DROP TABLE或CREATE TABLE,容易引发锁竞争
外键约束会让 RENAME TABLE 失败
如果原表被其他表的外键引用(比如 orders.user_id → users.id),直接 RENAME TABLE users TO users_v2 会失败,并报错 ERROR 1826 (HY000): Duplicate foreign key constraint name 或更常见的 ERROR 1025 (HY000): Error on rename。
根本原因是 MySQL 要求外键约束名全局唯一,而重命名后系统尝试自动迁移约束时可能冲突,或引用关系未同步更新。
- 必须先
ALTER TABLE referencing_table DROP FOREIGN KEY fk_name;删除外键 - 再执行
RENAME TABLE - 最后用新表结构重建外键:
ALTER TABLE referencing_table ADD CONSTRAINT fk_user_v2 FOREIGN KEY (user_id) REFERENCES users_v2(id); - 注意:InnoDB 不允许在重命名过程中保留外键引用原表名,也不支持自动重映射
rename table 不会复制数据,也不影响已有连接
RENAME TABLE 是纯元数据操作,不涉及行数据移动或拷贝,所以无论表有多大,执行都极快(毫秒级)。但它也不会触发任何触发器,不记录 binlog 中的行变更事件(只记 DDL 日志)。
已有连接中正在使用的表名不会自动更新——比如某连接之前执行了 SELECT * FROM users;,之后你重命名了表,该连接下次再查 users 就会报 ERROR 1146 (42S02): Table doesn't exist。
- 应用层若缓存了表名(如 ORM 映射、预编译 SQL),需同步更新配置或重启服务
- 备份脚本、ETL 任务、监控查询中硬编码的表名,全部要人工检查替换
- 视图(VIEW)不会自动跟随重命名,依赖原表的视图会失效,需用
CREATE OR REPLACE VIEW重建
实际执行前,最好先用 SHOW CREATE TABLE 和 SELECT COUNT(*) 确认表结构和数据量;跨库或带外键的操作,务必在测试库走一遍完整流程——这些细节一旦漏掉,上线时就不是改个名字的事了。










