如何配置MySQL 8.0的克隆插件(Clone Plugin)实现快速数据迁移?

雨强姑娘_6467

雨强姑娘_6467

2026-07-03

369人浏览

原创

MySQL 8.0.17+才支持CLONE插件,必须版本≥8.0.17、插件状态为ACTIVE、配置持久化、分端授权(donor需BACKUP_ADMIN,recipient需CLONE_ADMIN)、设clone_valid_donor_list、克隆后删除auto.cnf防UUID冲突。

如何配置mysql 8.0的克隆插件(clone plugin)实现快速数据迁移?

CLONE 插件不是“装上就能用”的功能,它对版本、权限、配置、网络和文件系统都有硬性要求。MySQL 8.0.17+ 才真正支持远程克隆,低于该版本或配置错一步,CLONE INSTANCE 就会静默卡住、报错退出,甚至删光目标数据。

确认 MySQL 版本与插件状态是否为 ACTIVE

很多失败从第一步就埋下了:你以为插件已启用,其实只是 INSTALL PLUGIN 过但没持久化,或者版本根本不够。

  • 执行 SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'clone'; —— 必须返回 ACTIVE;若为空或 DISABLED,说明未加载
  • 检查版本:SELECT VERSION(); 必须 ≥ 8.0.17;8.0.27 之前不支持并发 DDL,克隆时源库所有 DDL 会被阻塞
  • 动态安装仅临时有效:INSTALL PLUGIN clone SONAME 'mysql_clone.so';(Linux)或 INSTALL PLUGIN clone SONAME 'mysql_clone.dll';(Windows)
  • 永久生效必须写进 my.cnf 的 [mysqld] 段:
    plugin-load-add = mysql_clone.so<br>clone = FORCE_PLUS_PERMANENT
    否则重启后插件丢失,CLONE 命令直接报 Unknown command 'CLONE'

本地克隆 vs 远程克隆:别用错命令模式

误把 CLONE LOCAL DATA DIRECTORY 当成扩容手段,会清空目标路径下所有文件(包括非 MySQL 数据);而用 CLONE INSTANCE FROM 却没配 donor 白名单,又会连不上。

  • 本地克隆只适用于同一台机器新建实例:CLONE LOCAL DATA DIRECTORY = '/data/clone_20260609'; —— 目标路径必须不存在,且属主为 mysql:mysql,否则报 Permission denied
  • 远程克隆才是迁移主力:CLONE INSTANCE FROM 'clone_donor'@'192.168.0.101':3306 IDENTIFIED BY 'pwd'; —— 注意用户是 donor 端的账号,不是当前登录账号
  • 远程克隆前,recipient 必须先设白名单:SET GLOBAL clone_valid_donor_list = '192.168.0.101:3306';(不能带 http://,IPv6 不支持)
  • donor 的 bind_address 不能是 127.0.0.1,得设为 0.0.0.0 或具体内网 IP,并放行防火墙/SELinux

权限必须分端配置,不能复用一个账号

克隆不走 SQL 层,REPLICATION SLAVE 权限完全无效;用错权限,认证阶段就会卡死或报 ERROR 3095 (HY000): Insufficient privileges。

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • donor(源库)用户只需:GRANT BACKUP_ADMIN ON *.* TO 'clone_donor'@'%';
  • recipient(目标库)用户必须有:GRANT CLONE_ADMIN ON *.* TO 'clone_recip'@'%';(该权限隐含 SHUTDOWN,因为克隆后会自动重启 mysqld)
  • 不要给同一个账号同时授 BACKUP_ADMIN 和 CLONE_ADMIN——权限混淆易导致 donor 认证失败
  • donor 用户密码需明文一致,且 donor 必须允许从 recipient 主机 IP 连入(如 'clone_donor'@'192.168.0.102' 更安全)

克隆后必须手动处理 auto.cnf 和 server_uuid

克隆是物理快照,auto.cnf 里的 server-uuid 会原样复制过去。如果不删,新实例启动时因 UUID 冲突直接拒绝服务,或后续配主从时报 GTID_PURGED conflict。

  • 克隆完成后,recipient 的 MySQL 会自动退出并由 systemd/mysqld_safe 拉起;此时立刻停服务:systemctl stop mysqld
  • 删除 /var/lib/mysql/auto.cnf(或你的 datadir 下对应文件),让 MySQL 重启时重生成唯一 server-uuid
  • 检查 SELECT @@server_uuid; 是否已变更;再查 SELECT BINLOG_FILE, BINLOG_POSITION FROM performance_schema.clone_status; 获取 donor 的 binlog 位点,用于后续主从配置
  • innodb_file_per_table=OFF 的旧实例无法被克隆;目标端若仍启用该模式,会触发 Invalid tablespace file

克隆不是“一键复制”,它是物理层操作,依赖底层文件系统支持硬链接(ext4/xfs)、两端参数对齐(如 innodb_log_file_size)、以及 donor 的 redo 日志持续可读。最容易被跳过的动作——删 auto.cnf、设 clone_valid_donor_list、分端赋权——恰恰是生产环境失败率最高的环节。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

mysql

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2393

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1439

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

855

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

3372

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

5768

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1259

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

6031

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

5222

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

7014

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 193人学习