PostgreSQL 到 OceanBase

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

选择对端数据库：

OceanBase

数据链路

基本功能

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

高级功能

功能	说明
全量前清空目标数据	运行全量任务前清除老数据，包括重跑任务、定时全量迁移都会触发此能力
重建目标表	运行全量任务前重建目标表，包括重跑任务、定时全量迁移都会触发此能力
高并发行级写入	适配分布式数据库特征，默认采用高并发行级写入策略 (ROW)
增量写入冲突策略	IGNORE: 遇到主键冲突则忽略（不做写入），REPLACE: 遇到主键冲突则整行替换
自定义代码	文档1：创建自定义代码任务 文档2：自定义代码任务 debug 文档3：在自定义代码中打日志
添加虚拟列	支持添加自定义的虚拟列，指定的值为固定值，如区域、编号等
设置目标主键	变更主键为其他字段，方便数据聚合等操作

限制和注意点

限制项	说明
OceanBase 版本	当前仅支持 OceanBase for MySQL 版本
OceanBase 数据类型	不支持地理位置类型

使用示例

标题	详情
主流 RDB 到 OceanBase 迁移同步	文档：RDB 到 OceanBase 迁移同步

---

源端数据源

前置条件

条件	说明
账号权限	需要权限如下(以自建数据库为例): GRANT ALL PRIVILEGES ON DATABASE 同步库 TO 同步账号（或同步库 information_schema 中所有视图的 SELECT 权限和需要同步表、索引、约束的 SELECT 权限) ALTER USER 同步账号 REPLICATION
增量同步准备	准备动作按如下步骤进行: 修改 postgresql.conf, 设置 wal_level=logical 和 wal_log_hints = on 修改 pg_hba.conf, 设置 host replication 同步账号 CIDR网段 md5 , host 同步库 同步账号 CIDR网段 md5, host postgres 同步账号 CIDR网段 md5 重启 PostgreSQL
网络准备	迁移同步节点（sidecar）可连接 PostgreSQL 标准交互接口（如 5432）

任务参数

参数名称	说明
fullFetchSize	全量扫描数据设置的 fetch size
eventStoreSize	缓存解析完毕的增量事件缓存大小
ignoreGisSRID	解析 GIS 数据类型时是否忽略 SRID
defaultGisSRID	设置 GIS 数据类型的 SRID

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

---

目标端数据源

前置条件

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

任务参数

参数名称	说明
keyConflictStrategy	增量写入遇到主键冲突策略: IGNORE 冲突忽略（默认） REPLACE 冲突替换（可选）
writeStrategy	对端写入策略，包含 ROW (单条，默认选项) MULTI_SQL (多语句) BATCH (批量)

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