MySQL 9.7 的 Clone 能跨 LTS 了,但只放开一代:9.7→10.7 可以,9.7→11.7 不行
WL#16520 的任务名叫 “InnoDB: Allow clone from one LTS version to the next”,状态 Complete,落在 Server-9.x:
- Worklog:
- 9.7.0 Release Notes:
它的目标很克制:放宽 Clone 的版本限制,但只允许 in-place upgrade 支持、而 in-place downgrade 不支持的那些组合。换句话说,能升级上去的路径,才允许物理搬过去。
规则矩阵:只放开“同代”和“相邻下一代 LTS”
Clone 之前要求源端和副本是同一个 server version。WL#16520 之后:
| 源 → 副本 | 是否允许 |
|---|---|
| 9.7.x → 9.7.y(同一 LTS 内) | 允许 |
| 9.7.x → 10.7.y(紧邻的下一个 LTS) | 允许 |
| 9.7.x → 11.7.y(跨过一代 LTS) | 不允许 |
| 10.7.x → 9.7.y(高版本源到低版本副本) | 不允许 |
| 9.7.x → 8.4.y 或 9.z(z<7) | 不允许 |
| 8.x.y 或 9.z(z<7)→ 9.7.x | 不允许 |
| 9.7.x → 10.0.y、10.4.x → 10.7.y 这类非 LTS 且 major/minor 不一致 | 不允许 |
几条边界要单独记:
- 只对 9.7 及以上版本生效,8.4 不在这个规则里。
- 跨代必须是紧邻的:
replica.major == source.major + 1,不是“任意更高的 LTS”。 - 降级一律禁止:高版本源不能喂给低版本副本。
- FR-4 单独兜底:只要源或副本有一方不是 LTS(即 Innovation Release),并且 major 和/或 minor 不一致,就不允许克隆。所以
9.7.x → 10.0.y、10.4.x → 10.7.y都会被挡下。
背景:clone 靠的是“配置对配置”的校验
克隆时,源端会把一组预定的配置发给副本,副本拿这些值和自己的配置比对,再决定这次克隆是否放行。这些值通过 sysvar service 读取系统变量,其中 version 系统变量用来判定 server 版本。
问题在于:光有版本号不够。要判断“是不是紧邻的 LTS”,clone 必须知道某个版本是 Long Term Stability(LTS)还是 Innovation Release(IR)。这个信息来自构建期生成的 MYSQL_VERSION_MATURITY 宏,因此它也必须从源端传到副本端。
而 clone 以前是把每条配置独立校验的:版本校验只看 version,彼此不关联。现在 version 和 maturity 必须放在一起看,才能得出“这是不是同代/相邻代”的结论。
实现:把 version 和 maturity 打包成一个 JSON
源端新增一条配置 maturity,取值就是 MYSQL_VERSION_MATURITY,即 "LTS" 或 "INNOVATION"。为了能让 version 和 maturity 并行处理,两者被打包进同一个 JSON 字符串:
- 源端构造一个 JSON 文档,里面是 name/value 对,分别对应
version和maturity,序列化后发给副本; - 副本构造自己的 JSON 文档,反序列化源端那份,用 sysvar reader service 和
MYSQL_VERSION_MATURITY填充自己的值,然后执行兼容性检查。
协议层面,clone protocol 升到 CLONE_PROTOCOL_VERSION_V4,新增 COM_RES_CONFIG_V4 命令来承载这个 JSON。低版本协议仍然走旧机制,向后兼容保留。
兼容性判断:are_versions_clone_compatible()
检查函数按下面的顺序短路返回:
are_versions_clone_compatible(replica, source):
if replica == source: return true
if replica.major == source.major and replica.minor == source.minor: return true
if replica.major != source.major:
if replica < source: return false # 不支持降级
if replica < 9.7.0 or source < 9.7.0: return false
if replica.maturity != LTS or source.maturity != LTS: return false
if replica.major != source.major + 1: return false
return true
# major 相同、minor 不同
return false # 对 Innovation 不做支持
拆开看就是四道闸:版本完全相同 → 放行;major/minor 都相同 → 放行;major 不同时,先排除降级,再排除 9.7 以下的版本,再排除任一方非 LTS,最后要求 major 恰好差 1;major 相同但 minor 不同,直接拒绝,不对 Innovation 版本做兼容。
为什么能放宽:物理格式对上一个 LTS 向后兼容
Clone 做的是运行中实例的动态物理快照,副本侧用常规 recovery 从快照恢复,所以它天然依赖数据和日志的物理格式。历史上要求两端 server version 完全一致,就是为了保证物理格式对得上。
放宽的依据是:物理格式的变更对上一个 LTS 保持向后兼容。既然从 9.7 的数据文件能走到 10.7,那么 9.7 的快照在 10.7 上恢复也就成立。但再往前一代(11.7)就没有这层保证,于是被规则矩阵挡掉。
实操建议
- 克隆只用于同代或升一代的物理搬机:9.7.x → 9.7.y 做小版本漂移,或者 9.7.x → 10.7.y 做 LTS 升级时的快速建库,这两类放心用。
- 降版本不要试:10.7.x → 9.7.y 会直接被拒绝,逻辑上也没有物理格式的兼容承诺。
- 跨两代不行:9.7.x → 11.7.y 不满足
major + 1,必须先升到 10.7 再往上走,或者干脆不用 clone。 - 这些情况走 dump + upgrade:降版本、跨两代、以及源或副本是 Innovation Release 且 major/minor 不一致的组合,都老老实实逻辑导出再按升级路径走。
- 9.7 以下的实例(比如 8.4.x)不在这套规则覆盖范围内,与 9.7 之间双向都不允许克隆。
9.7.0 的 release note 对此的表述是:Clone 插件现在支持在高于 9.7.0 的连续 LTS 版本之间克隆,细节参见 Clone Plugin Limitations 与 Remote Cloning Prerequisites。