MySQL 到 OpenGauss

CloudCanal 支持从 MySQL 到 OpenGauss 的数据迁移、同步、校验和链路能力。

选择对端数据库：

OpenGauss

数据链路

基本功能

功能	说明
结构迁移	如目标不存在所选表，则自动根据源端元数据，结合映射生成对端创建语句并执行创建
全量数据迁移	逻辑迁移，通过顺序扫描表数据，将数据分批写入到对端数据库
增量实时同步	支持 INSERT, UPDATE, DELETE 常见 DML 同步
数据校验和订正	全量数据校验，并可选根据校验结果订正差异数据，支持定时，文档：创建定时校验订正任务
修改订阅	新增、删除、修改订阅表，支持历史数据迁移，文档：修改订阅
重置位点	支持按照文件位点、时间戳 回溯位点，重新消费过去一段时间或指定 Binlog 文件和位点开始的增量日志
表名映射	支持 和源端保持一致, 转小写, 转大写, 以'_数字'后缀截取
DDL 同步	ALTER TABLE ADD COLUMN, DROP COLUMN, MODIFY COLUMN, CHANGE COLUMN ADD INDEX RENAME TABLE
元数据检索	从源端表查对端，查询设置过过滤条件的，查询设置过对端主键的

高级功能

功能	说明
0 值时间处理	支持将 0 值时间设置成不同类型的值，防止写入对端报错
自定义代码	文档1：创建自定义代码任务 文档2：自定义代码任务 debug 文档3：在自定义代码中打日志
表达式表名	支持按正则表达式表名迁移同步数据，实现全库同步、分表汇聚等功能中自动增减表需求，文档：表达式任务
添加虚拟列	支持添加自定义的虚拟列，指定的值为固定值，如区域、编号等
设置目标主键	变更主键为其他字段，方便数据聚合等操作
数据过滤条件	支持 WHERE 条件进行数据过滤，内容为 SQL 92 子集，文档：创建数据过滤任务

限制和注意点

限制项	说明
MySQL 存储引擎	支持 InnoDB, MySIAM, 阿里云 XEngine, 其他存储引擎暂未测试
MySQL 字符集	支持 utf8, utf8mb4, latin1, 其他编码暂未测试

使用示例

标题	详情
MySQL 到 PostgresSQL 数据迁移同步	文档：MySQL 到 PostgresSQL 数据迁移同步

链路FAQ

• MySQL 任务延迟怎么办?

• MySQL 源端找不到 binlog 文件

• 如何打开 MySQL 源端心跳?

• MySQL 源端 Schema 权限报错怎么办?

  Tips: MySQL 源端相关 FAQ 同样适用于 MySQL 系数据源。

---

源端数据源

前置条件

条件	说明
账号权限	文档：MySQL / MariaDB 需要的权限
开启 Binlog	[mysqld] log-bin=mysql-bin # 开启 Binlog binlog-format=ROW # 选择 ROW 模式 binlog_row_image=FULL # 变更带所有列数据

任务参数

参数名称	说明
parseBinlogParallel	增量解析 Binlog 的并发数
parseBinlogBufferSize	用于增量解析 Binlog 的环形队列大小
maxTransactionSize	单事务最大数据条数，超过则分段刷出
limitThroughputMb	限制增量 Binlog 流量
extraDDL	兼容额外的 DDL 同步，包括 PT, GHOST, ALI_DMS, PT_GHOST
fullDataSqlConditionEnabled	将过滤条件拼入 SQL 中进行源端数据扫描，此参数只针对全量迁移有效
srcTimeZone	源端时区，例如 +08:00, Asia/Shanghai, America/New_York 等

Tips: 通用参数配置请参考 通用参数及功能

---

目标端数据源

前置条件

条件	说明
账号权限	具备 SELECT, INSERT, DELETE, UPDATE,常见 DDL 权限
网络准备	迁移同步节点（sidecar）可连接 OpenGauss 标准交互接口（如 5432）

任务参数

参数名称	说明
keyConflictStrategy	增量写入遇到主键冲突策略: IGNORE 冲突忽略（默认） REPLACE 冲突替换（可选）
dstWholeReplace	将 INSERT 和 UPDATE 操作变成对端的整行覆盖
enableTimeZoneProcess	是否对时间字段进行时区转换
timezone	目标端 OpenGauss 时区，例如 +08:00 Asia/Shanghai America/New_York
defaultZeroDate	在遇到'0000-00-00 00:00:00' / '0000-00-00' 值时用于替换的默认值，可选参数有： null (空值) 时间 (14:23:33) 日期 (1970-01-01) 时间日期 (1970-01-01 00:00:00), 时区时间 (14:23:33+08:00 或 1970-01-01 00:00:00+08:00)
caseSensitive	对端写入SQL语句表名大小写策略，包含 UpperCase (转大写) LowerCase (转小写) Sensitive (添加限定符) NoSpecified (不转换/不加限定符)
writeStrategy	对端写入策略，包含 ROW (单条) MULTI_SQL (多语句) BATCH (批量，默认选项) COPY (OpenGauss COPY 指令)
defaultGisSRID	设置 GIS 数据类型的 SRID

Tips: 通用参数配置请参考 通用参数及功能