MySQL 迁移 GaussDB 实战：DRS 在线迁移与手动离线迁移全攻略

1. 背景随着国产数据库的普及越来越多的企业将业务从 MySQL 迁移到华为云 GaussDB。迁移过程中如何保证数据一致性、缩短停机时间、处理语法兼容性是每个 DBA 和开发人员必须面对的问题。本文将介绍两种主流的迁移方案方案一使用华为云数据复制服务DRS进行在线迁移支持全量 增量同步停机时间最短适合生产环境。方案二手动离线迁移采用「M 兼容模式建库 mysqldump 导出结构/数据 gsql 导入」方案适合无 DRS 环境或小数据量场景。2. 方案一使用 DRS 在线迁移推荐生产环境首选2.1 适用场景华为云环境源库与目标库网络互通。要求低停机时间业务连续性要求高。希望自动处理部分语法转换减少人工干预。2.2 操作步骤第一步创建 GaussDB 实例在华为云控制台创建 GaussDB 实例确保与源 MySQL 网络互通VPC / 安全组配置。第二步创建 DRS 任务登录 DRS 控制台创建实时同步任务。源库选择 MySQL填写 IP、端口、账号密码。目标库选择 GaussDB填写实例 ID、账号密码。迁移类型选择「全量 增量」。第三步预检查与启动执行预检查修复报错项后启动任务。第四步业务割接等待 DRS 状态变为「增量同步」。停止源库写入业务。确认 DRS 无延迟后结束 DRS 任务。修改应用连接地址指向 GaussDB。3. 方案二手动离线迁移无 DRS 或小数据量3.1 关键前提GaussDB 必须创建为M 兼容模式DBCOMPATIBILITYM以最大程度兼容 MySQL 语法如自增主键、反引号等。3.2 目标库准备在 GaussDB 中创建兼容 MySQL 的数据库-- 创建M兼容模式的数据库CREATEDATABASEtarget_db DBCOMPATIBILITYM;3.3 导出源库结构Schema使用mysqldump仅导出表结构去除触发器和 GTID 信息避免兼容性问题。# 导出结构到 schema.sqlmysqldump-hMYSQL_IP-uUSER-p\--no-data\--skip-triggers\--set-gtid-purgedOFF\--skip-quote-names\source_dbschema.sql命令参数逐行解析参数含义-h MYSQL_IP指定源 MySQL 数据库的主机 IP 地址-u USER指定连接数据库的用户名-p提示输入密码交互式输入避免密码出现在命令行历史中--no-data只导出表结构DDL不导出表中的数据--skip-triggers跳过触发器避免 GaussDB 不兼容的触发器语法--set-gtid-purgedOFF不生成 GTID 相关的SET GLOBAL.GTID_PURGED语句避免导入时报错--skip-quote-names不使用反引号包裹表名和字段名因为 GaussDB 不识别反引号source_db要导出的源数据库名称 schema.sql将导出结果重定向写入schema.sql文件为什么这样配置--no-data这一步只迁移表结构数据在后续步骤单独处理避免结构文件过大、导入超时。--skip-triggersGaussDB 对 MySQL 触发器语法支持有限跳过可减少兼容性问题。--set-gtid-purgedOFFGTID 是 MySQL 主从复制的特性GaussDB 不识别必须关闭。--skip-quote-namesMySQL 默认用反引号包裹标识符而 GaussDB M 模式虽兼容反引号但去掉后能减少不必要的转义问题。注意若遇到索引名冲突或特殊字符可能需要手动编辑schema.sql。GaussDB M 模式下索引名在 Schema 内唯一而非表内唯一。3.4 导入结构到 GaussDB使用gsql客户端导入结构文件。# 导入结构gsql-hGAUSSDB_IP-pPORT-UUSER-WPASSWORD-dtarget_db-fschema.sql3.5 导出数据并导入为避免大事务超时建议按表导出数据和导入。导出所有表数据exportMYSQL_PWDYOUR_PASSWORD# 循环导出每个表的数据为单独SQL文件forTABLEin$(mysql-uUSER-hMYSQL_IP-N-eSHOW TABLES FROM source_db);domysqldump-uUSER-hMYSQL_IP\--no-create-info\--skip-triggers\--compact\--complete-insert\--set-gtid-purgedOFF\--skip-quote-names\source_db$TABLE${TABLE}.sqldone导入数据到 GaussDB# 循环导入每个表的数据forFILEin*.sql;doechoImporting$FILE...gsql-hGAUSSDB_IP-pPORT-UUSER-WPASSWORD-dtarget_db-f$FILEdone3.6 手工迁移中容易踩坑的点1. 字符集与排序规则不一致MySQL 默认utf8mb4而 GaussDB 默认UTF8。若源库表使用了utf8mb4_general_ci等排序规则导入 GaussDB 后可能出现中文乱码或排序异常。-- 导出前确认源库字符集SHOWCREATETABLEsource_table;-- 导入前在 GaussDB 中设置客户端编码SETclient_encodingUTF8;2. 外键约束导致导入顺序错误MySQL 导出时默认按表名排序若表之间存在外键依赖直接按字母序导入会因父表未建而报错。# 导出时禁用外键检查在 schema.sql 开头添加SET session_replication_rolereplica;3. 大字段BLOB/TEXT导入超时gsql默认单条语句超时时间较短导入包含大字段的表时容易中断。# 导入时增加超时时间gsql-hGAUSSDB_IP-pPORT-UUSER-WPASSWORD\-dtarget_db-f$FILE--statement-timeout04. 空字符串与 NULL 的差异MySQL 中和NULL是不同值但 GaussDB 某些场景下会将空字符串转换为NULL导致数据不一致。-- 导入后检查空字符串是否被转换SELECTCOUNT(*)FROMtarget_tableWHEREcolumn_name;5. 分区表语法不兼容MySQL 的分区表语法如PARTITION BY HASH在 GaussDB 中写法不同需手动改写为 GaussDB 的分区语法。6. 视图与存储过程需单独处理mysqldump导出的视图和存储过程在 GaussDB 中可能无法直接执行需逐个检查并改写。# 单独导出视图mysqldump-hMYSQL_IP-uUSER-p\--no-data --skip-triggers --set-gtid-purgedOFF\source_db view_nameview_name.sql7. 导入后索引失效GaussDB 导入数据后部分索引可能未自动重建需手动执行ANALYZE更新统计信息。-- 更新统计信息ANALYZEtarget_table;4. 常见兼容性修正与注意事项4.1 自增主键M 模式下支持AUTO_INCREMENT但插入数据时若指定 ID 值需注意序列同步。若手动插入数据后需重置序列-- 示例重置表 test_table 的 id 序列SELECTsetval(test_table_id_seq,(SELECTMAX(id)FROMtest_table));4.2 数据类型差异MySQLTINYINT(1)通常映射为 GaussDBBOOLEAN或SMALLINT需检查业务逻辑。MySQLDATETIME默认值0000-00-00 00:00:00在 GaussDB M 模式中不支持需改为NULL或合法时间。MySQLENUM/SET类型在 GaussDB 中支持有限建议转换为VARCHAR或字典表。4.3 保留字冲突GaussDB 有更多保留字如order、user若表名或字段名为保留字需用双引号包裹如user。4.4 JSON 类型GaussDB M 模式对 JSON 支持有所限制复杂 JSON 操作可能需调整为JSONB或文本处理。4.5 大小写敏感GaussDB 默认标识符小写若 MySQL 表名大写需在 SQL 中使用双引号或统一转换为小写。5. 数据校验迁移完成后对比源库和目标库的记录数及关键字段哈希值。-- 在GaussDB中执行SELECTCOUNT(*)FROMtarget_table;-- 在MySQL中执行SELECTCOUNT(*)FROMsource_table;6. 总结对比项DRS 在线迁移手动离线迁移停机时间最短增量同步较长需停写导出导入操作复杂度低控制台可视化高需脚本处理语法转换自动处理部分转换需手动修正兼容性适用场景生产环境、大数据量无 DRS 环境、小数据量选择哪种方案取决于您的业务场景和对停机时间的容忍度。生产环境强烈推荐使用 DRS 在线迁移若条件受限手动离线迁移配合 M 兼容模式也能顺利完成迁移任务。