从 MySQL 迁移至 MatrixOne

开始前请先阅读数据迁移兼容性 Cookbook,其中定义了十条可移植性规则和按版本执行的额外检查。不要对 MatrixOne 目标端使用 mysqldump;MatrixOne 的逻辑备份请使用 mo-dump。

本页以 MySQL 8.0.44 到 MatrixOne v4.2.5 为实测小样本基线。迁移前固定源、目标、驱动与导出工具版本;MySQL 协议可连接不等于所有对象和 SQL 语义相同。

兼容性评估

记录表/主键/业务键、整数符号与范围、DECIMAL 精度、字符集与排序规则、NULL/空串、时区、JSON/二进制/空间数据,以及约束、生成列、分区、索引、视图、过程、触发器、EVENT 和用户权限。检查目标数据类型及MySQL 兼容性。

v4.2.5 支持 SQL/Starlark 过程,但过程体语法不同;DML 触发器和 MySQL EVENT 不支持。转换这些对象必须有明确业务替代方案。ENGINE=InnoDB 被解析/忽略不代表 InnoDB 的锁、排序规则、事务或物理存储语义被复制。

选择全量方式

方式

适用与限制

DBeaver/JDBC

小批量试迁移;按内存、语句字节数、事务和错误重试设置批次。逐表复制不提供跨表一致性或 CDC

mysqldump SQL

先审查 DDL/会话语句,再导入。--single-transaction 适用于受支持的事务表;避开并发 DDL,非事务表另行处理

mysqldump -T / CSV + LOAD DATA

-T 文件在 MySQL 服务端产生,需 FILE 权限、secure_file_priv 和目录可写;MO 端另需访问导出的文件

DataX

reader/writer/驱动固定并独立验证;通常先建目标结构,不等于持续入站 CDC

批次数 5000 或 net_buffer_length=10m 都不是直接写 S3 的充分条件。根据实际工作负载测试吞吐、内存、语句大小和事务耗时。

SQL 文件导入

在停写或已建立一致读取点的源端导出。以下是数据导出的命令模板;先按已审查的 DDL 创建隔离目标,填写源地址、账号、库和表,密码交互输入,不使用失败继续选项:

mysqldump --host="$MYSQL_SOURCE_HOST" --port="$MYSQL_SOURCE_PORT"   --user="$MYSQL_SOURCE_USER" --password   --single-transaction --set-gtid-purged=OFF --no-tablespaces   --no-create-info --skip-triggers --compact --skip-add-locks --hex-blob   source_database source_table > reviewed_data.sql
mysql --host="$MO_TARGET_HOST" --port="$MO_TARGET_PORT"   --user="$MO_TARGET_USER" --password --default-character-set=utf8mb4   target_database < reviewed_data.sql

命令里的库表名是模板,两个系统必须映射到同一个逻辑对象。保留工具退出码与错误,检查此前已提交的批次,重跑前决定幂等/补偿方式。不要把“遇到报错仍继续”写成完整性保证。SOURCE 只在 MySQL CLI 中使用;JDBC/PyMySQL 应按驱动接口执行完整 SQL 语句。

这轮默认 mysqldump 与上述数据导出选项在小样本中均导入成功;这只验证被测表,不能推广为任意 DDL、过程、触发器、GTID 或库对象自动兼容。

文件与编码

导出/导入必须匹配列顺序、分隔符、引号、转义、换行、header、NULL 标记和字符集。\N、空字段与空字符串不是同一值。用包含 Unicode 补充字符、引号、分隔符、换行和二进制零字节的数据试迁移;按原始字节/HEX 复核,避免界面或驱动解码掩盖问题。LOAD DATA INFILE、LOCAL 和对象存储路径分别验证可达性。

增量与切换

源端继续写入时,必须绑定一致性全量点与 binlog/GTID 起点,验证 insert/update/delete、事务顺序、DDL、重复与恢复。现有 mo_cdc 是 MO 源端工具,不能仅凭 mysql:// URI 作为 MySQL 入站 CDC。没有经过验证的入站连接器时,采用明确的停写迁移窗口。

停止源端写入后记录最后位置、追平、处理异常、执行数据校验与回退流程,再切换客户端和后台写入口。目标开始接受新写入后,回退需要保留并处理这些数据。

教程与验证范围

见可运行 MySQL 迁移实验。实测保留 DECIMAL、NULL/空串、Unicode、二进制和微秒时间,验证了金额损坏但行数相同的负对照;手动变更回放不是 CDC 认证。DBeaver/DataX 和生产不停写切换尚未实测。