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(*)确认表结构和数据量;跨库或带外键的操作,务必在测试库走一遍完整流程——这些细节一旦漏掉,上线时就不是改个名字的事了。
