MySQL 到 MatrixOne:可运行的小样本实验

使用独立的 MySQL 8.0 与 MO v4.2.5 实例,确认实验库名不存在。实验假定源端在复制期间停写;不验证生产 CDC 或全量/日志衔接。两边通过各自客户端连接,记录 SELECT VERSION()。

创建源与目标

在两边分别执行以下 DDL。目标必须为空,脚本会检查;不能在生产库运行。

CREATE DATABASE mo_mysql_migration_lab;
USE mo_mysql_migration_lab;
CREATE TABLE orders(
    id BIGINT PRIMARY KEY,
    amount DECIMAL(20,4),
    label VARCHAR(100),
    nullable_value VARCHAR(30),
    raw_bytes VARBINARY(16),
    event_at DATETIME(6)
);

只在 MySQL 源端插入包含 Decimal、Unicode、NULL/空串、二进制和微秒时间的样本:

INSERT INTO orders VALUES
(1,999999999999.1234,'空间😀',NULL,X'00FF','2026-01-01 08:00:00.123456'),
(2,0.0000,'quote,pipe|','',X'5C00','2026-01-02 08:00:00.000001'),
(3,-10.5000,'delete-me','value',X'616263','2026-01-03 08:00:00');

复制并逐行比较

安装 PyMySQL,按真实连接设置 MYSQL_SOURCE_HOST/PORT/USER/PASSWORD 与 MO_TARGET_HOST/PORT/USER/PASSWORD 环境变量,将下面脚本保存为 mysql_to_mo_lab.py 后用 Python 运行。不打印密码;两边账号仅访问自己的实验库。

import os
import pymysql

# Only run against isolated lab databases; neither table may contain business data.
source = pymysql.connect(
    host=os.environ['MYSQL_SOURCE_HOST'], port=int(os.environ['MYSQL_SOURCE_PORT']),
    user=os.environ['MYSQL_SOURCE_USER'], password=os.environ['MYSQL_SOURCE_PASSWORD'],
    database='mo_mysql_migration_lab', charset='utf8mb4', autocommit=True)
target = pymysql.connect(
    host=os.environ['MO_TARGET_HOST'], port=int(os.environ['MO_TARGET_PORT']),
    user=os.environ['MO_TARGET_USER'], password=os.environ['MO_TARGET_PASSWORD'],
    database='mo_mysql_migration_lab', charset='utf8mb4', autocommit=True)
columns = 'id,amount,label,nullable_value,raw_bytes,event_at'
select_sql = 'SELECT ' + columns + ' FROM orders ORDER BY id'
try:
    with source.cursor() as cur:
        cur.execute('SET SESSION TRANSACTION ISOLATION LEVEL REPEATABLE READ')
        cur.execute('START TRANSACTION WITH CONSISTENT SNAPSHOT')
        cur.execute(select_sql)
        rows = cur.fetchall()
    with target.cursor() as cur:
        cur.execute('SELECT COUNT(*) FROM orders')
        assert cur.fetchone()[0] == 0, 'target must be empty'
        cur.executemany('INSERT INTO orders VALUES(%s,%s,%s,%s,%s,%s)', rows)
        cur.execute(select_sql)
        actual = cur.fetchall()
    assert actual == rows, 'row/value reconciliation failed'
    print('Exact source/target rows match:', len(rows))
finally:
    source.rollback()
    source.close()
    target.close()

预期显示 3 行精确一致。参数绑定避免手工 SQL 字符串替换,DECIMAL 使用驱动的 Decimal 表示,原始字节不先转文本。这个单表脚本把所有行读入内存,生产需要流式/分片处理和可恢复批次;不能直接扩大数据量使用。

错误负对照与手动回放

在目标把 id=2 的 amount 改为 1,行数仍为 3;用脚本的 SELECT 分别读取两边比较,会发现差异。只修复该实验行后,再比较。继续在源端修改 id=1、删除 id=3、新增 id=4,把对应变化手动应用到目标,再比较完整行与键集。这一步验证数据和应用语义,不是自动 CDC。

删除、插入重试需明确幂等策略;重复执行同一 INSERT 不等于 exactly-once。切换和真实连接器要求见迁移流程。

清理与验证证据

完成后仅删除两边自己的 mo_mysql_migration_lab。本脚本在 MySQL 8.0.44 与 MO v4.2.5 实际执行,逐行比较通过;另外验证了 mysqldump/客户端导入与包含引号、换行、二进制、NULL 的样本。没有执行 DBeaver/DataX 或生产 CDC。