PolarDbX

选择对端数据库：

MySQL

数据链路

基本功能

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

高级功能

功能	说明
自定义代码	文档1:创建自定义代码任务 文档2:自定义代码任务debug 文档3:在自定义代码中打日志
数据过滤条件	支持 WHERE 条件进行数据过滤，内容为 SQL 92 子集, 文档:创建数据过滤任务
全量前清空目标数据	运行全量任务前清除老数据，包括重跑任务、定时全量迁移都会触发此能力
0值时间处理	支持将 0 值时间设置成不同类型的值，防止写入对端报错
增量写入冲突策略	IGNORE: 主键冲突则忽略（不做写入），REPLACE: 主键冲突则整行替换

字段类型与映射

展开字段类型映射表格

---

源端数据源

前置条件

条件	说明
账号权限	云数据库为读写权限账号 自建数据库权限: GRANT SELECT ON . TO 'user'@'host' GRANT REPLICATION CLIENT ON . TO 'user'@'host' GRANT REPLICATION SLAVE ON . TO 'user'@'host'

任务参数

参数名称	说明
parseBinlogParallel	增量解析 binlog 的并发数
parseBinlogBufferSize	用于增量解析 binlog 的环形队列大小
maxTransactionSize	单事务最大数据条数，超过则分段刷出
limitThroughputMb	限制增量 binlog 流量
needJsonEscape	将 json 中特殊字符进行转义，以写入到对端

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

---

目标端数据源

前置条件

条件	说明
账号权限	文档：MySQL / MariaDB 需要的权限
网络准备	迁移同步节点( sidecar )可连接 MySQL / MariaDB 标准交互接口(如 3306)

任务参数

参数名称	说明
keyConflictStrategy	增量写入遇到主键冲突策略，IGNORE 冲突忽略(默认)，REPLACE 冲突替换(可选),EXCEPTION 报错停止(暂不支持)
dstWholeReplace	将 INSERT 和 UPDATE 操作变成对端整行覆盖
deCycle	双向同步过滤开关，过滤特定标记的 DML/DDL
specialSqlMode	初始化数据库链接时，可以设置特定的 sql mode
defaultGisSRID	设置 GIS 数据类型的 SRID

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

数据链路

基本功能

高级功能

限制和注意点

使用示例

字段类型与映射

链路FAQ

源端数据源

前置条件

任务参数

目标端数据源

前置条件

任务参数