MySQL Clone 插件怎么只复制到本地目录

如果只想把当前 MySQL 实例复制到同一台服务器的一个新目录，不需要配置远程 donor，直接使用 CLONE LOCAL DATA DIRECTORY = '/绝对路径/新目录'。真正容易踩坑的是目录规则：父路径必须已经存在，最后一级目标目录必须尚不存在，而且运行 mysqld 的系统账号要有创建和写入权限。

官方文档：https://dev.mysql.com/doc/refman/8.4/en/clone-plugin-local.html

先分清本地克隆的三个边界

我第一次使用 Clone 插件时，最容易误会的是“本地”两个字：它不是把文件下载到 mysql 客户端所在电脑，而是由 MySQL Server 在自己运行的那台主机上创建新目录。客户端只提交 SQL，真正读取源 datadir、创建目标目录和写文件的都是 mysqld 进程。

因此，目录权限要检查服务器系统账号，而不是你登录 shell 的个人账号。也不要提前创建最终目标目录；只创建它的父目录即可。

第一步：确认 Clone 插件已经启用

先查询插件状态，看到 ACTIVE 才继续。下面的 SQL 只读取插件元数据：

-- 查看 clone 插件是否已经加载并处于可用状态。
SELECT PLUGIN_NAME, PLUGIN_STATUS
FROM INFORMATION_SCHEMA.PLUGINS
WHERE PLUGIN_NAME = 'clone';

如果没有记录，可由具备插件管理权限的管理员安装。Unix 类系统通常使用 mysql_clone.so，Windows 对应动态库后缀不同：

-- 运行时安装并注册插件，后续正常重启仍会加载。
INSTALL PLUGIN clone SONAME 'mysql_clone.so';

插件库必须位于 plugin_dir 指定的目录。安装失败时查看 MySQL 错误日志，不要反复执行本地克隆语句。

第二步：给专用账号最小必要权限

执行本地克隆需要全局 BACKUP_ADMIN。建议使用专用运维账号，避免把日常应用账号提升为备份管理员：

-- 创建示例运维账号；密码请替换为安全的凭据管理方案。
CREATE USER 'clone_user'@'localhost' IDENTIFIED BY 'Replace-With-Strong-Password';

-- 本地 CLONE 语句需要全局 BACKUP_ADMIN。
GRANT BACKUP_ADMIN ON *.* TO 'clone_user'@'localhost';

如果账号已经存在，只执行授权语句即可。操作完成后可根据组织权限策略撤销或锁定该账号。

第三步：只创建父目录，不创建目标目录

假设计划把克隆写到 /srv/mysql-clones/clone-20261006。应先准备 /srv/mysql-clones，但不要执行 mkdir clone-20261006。以下命令中的系统账号以常见的 mysql 为例，实际环境应以 mysqld 的运行用户为准：

# 只创建父目录，最终的 clone-20261006 必须保持不存在。
sudo mkdir -p /srv/mysql-clones

# 让 mysqld 运行账号可以在父目录下创建并写入新目录。
sudo chown mysql:mysql /srv/mysql-clones
sudo chmod 750 /srv/mysql-clones

# 确认目标目录目前不存在；有输出就先换一个新目录名。
test ! -e /srv/mysql-clones/clone-20261006 && echo "目标目录可用"

这里必须使用绝对路径。相对路径、已经存在的目标目录、父目录缺失或 mysqld 无写权限，都会让语句失败。

第四步：执行本地 CLONE 语句

条件满足后，用获得 BACKUP_ADMIN 的账号连接当前实例并执行：

-- 把当前实例的数据复制到同机的新目录，不连接远程 donor。
CLONE LOCAL DATA DIRECTORY = '/srv/mysql-clones/clone-20261006';

等号可以省略，但保留能让语句更醒目。这个操作会把受支持的 InnoDB 用户表、系统表空间、redo 日志和 undo 表空间复制到指定目录。它不是逻辑导出，不会生成逐表 SQL 文件。

第五步：从另一个会话查看状态和阶段

本地克隆可能持续一段时间。另开数据库会话查询 Performance Schema，可以区分正在执行、已经完成和失败：

-- 查看当前或最近一次克隆的总体状态与错误信息。
SELECT STATE, ERROR_NO, ERROR_MESSAGE
FROM performance_schema.clone_status;

-- 查看文件复制、页复制、redo 复制等阶段状态。
SELECT STAGE, STATE, BEGIN_TIME, END_TIME
FROM performance_schema.clone_progress
ORDER BY ID;

clone_status.STATE 可能显示 Not Started、In Progress、Completed 或 Failed。失败时先读 ERROR_NO 和 ERROR_MESSAGE，目录权限、空间不足和不支持的表空间都应从具体错误判断。

克隆完成后检查什么

完成后先确认 clone_status 为 Completed，再由服务器管理员检查目标目录归属、容量和文件清单。不要仅凭目录已经出现就判定成功，因为失败任务也可能留下中间文件和错误状态。

如果源实例有用户自建表或表空间放在 datadir 之外，本地克隆不支持直接复制它们。官方文档说明这种情况可能因目标路径冲突而报错；应先盘点外部表空间，再改用适合的备份或迁移方案。

我会在什么场景使用它

对我来说，本地 Clone 更适合在同机准备一份物理数据副本，例如受控测试、迁移前暂存或后续由独立实例接管。它的优势是语句短、路径明确，缺点也很直接：需要额外磁盘空间、服务器写权限，而且不能把目录外对象当作不存在。

如果目标在另一台服务器，应研究远程 Clone，而不是把本地目标写到网络挂载后假装成远程流程。如果需要可跨版本、可逐表恢复的备份，逻辑导出或专门备份工具通常更合适。Clone 解决的是物理克隆问题，不是所有备份需求的替代品。

清理与复用注意事项

不要让下一次任务复用同一个目标目录名，因为 Clone 要求目标目录不存在。确认克隆副本已经不再使用后，再由服务器管理员按变更流程归档或删除；生产环境中不要把清理命令直接混进自动克隆脚本。

若要以克隆目录启动独立实例，还需要为端口、socket、PID、日志和权限准备隔离配置。仅仅把 datadir 指向新目录，不代表它可以与原实例安全地共用其他运行文件。

常见问题

为什么提示目标目录已经存在？

本地 Clone 要求最后一级目标目录不存在。保留父目录，换一个全新的目标目录名再执行。

可以写相对路径吗？

不可以，应提供完整绝对路径，并确保父路径真实存在且 mysqld 可写。

本地克隆会连接远程 MySQL 吗？

不会。CLONE LOCAL DATA DIRECTORY 从当前实例的数据目录复制到同一服务器或节点上的另一个目录。

为什么目录创建了但状态是 Failed？

目录出现只说明任务开始写入。以 performance_schema.clone_status 的状态和错误字段为准，再结合服务器错误日志处理。