Oracle 到 OceanBase 迁移实施方案：对象转换和增量同步实践

本文中的 OceanBase 指 OceanBase Oracle 模式租户。NineData 当前支持 Oracle 源端版本为 23ai、21c、19c、18c、12c 或 11g；目标端 OceanBase Oracle 模式，当前版本已适配 OceanBase V4.0。实际支持的数据库版本、对象类型和数据类型，以 NineData 持续更新的官方文档及任务预检查结果为准。

一、Oracle 迁移到 OceanBase的场景

Oracle 到 OceanBase 的迁移通常用于：

• 数据库国产化替代；
• 商业数据库成本优化；
• 数据库上云或跨云迁移；
• 业务系统扩容；
• 数据库版本升级；
• 生产库容灾和多活建设；
• Oracle 资源整合和架构改造。

OceanBase 提供 Oracle 模式，可以兼容部分 Oracle 使用习惯和 SQL 语法。但兼容模式不等于两个数据库完全等价。迁移时还是需要重点评估表结构、数据类型、索引、分区、序列、视图、触发器、存储过程、Package、Job 以及应用 SQL。

如果只做一次性导出导入，源库在迁移期间产生的新数据、更新和删除无法自动进入目标库。因此，生产迁移一般采用：

二、NineData 解决什么问题

NineData 数据复制支持通过复制任务组织 Oracle 到 OceanBase Oracle 模式的迁移流程，主要包括：

• 结构复制；
• 全量数据复制；
• DML 增量数据复制；
• DDL 增量数据复制；
• 任务状态和复制延迟监控；
• 数据一致性对比；
• 差异处理和重新同步；
• 异常告警；
• 迁移后的持续同步。

NineData 支持全对象类型的 DML 和 DDL 增量数据复制。这代表NineData 具备捕获和处理增量 DML、DDL 变更的产品能力。

需要区分的是：

• 产品能力：NineData 支持 DML/DDL 增量复制，能够捕获源端变更并写入目标端。
• 异构兼容性：某一条 Oracle DDL 是否能在 OceanBase Oracle 模式中完全等价执行，需要结合数据库版本、对象类型和目标端语法进行验证。

迁移团队仍需要负责对象兼容性评估、应用 SQL 改造和最终割接决策。

三、迁移前必须确认的前置条件

1.  确认目标端为 OceanBase Oracle 模式

创建目标数据源时，应确认使用的是 OceanBase Oracle 模式租户，而不是 MySQL 模式租户。

需要记录：

• OceanBase 集群版本；
• 租户模式；
• 租户字符集；
• 目标 Schema；
• 连接地址和端口；
• 租户 CPU、内存和磁盘资源；
• 目标端账号权限；
• 是否通过代理、专线或私网连接。

Oracle 到 OceanBase MySQL 模式和 Oracle 模式的迁移方法不同，不能混用对象映射和数据类型规则。

2.  准备 Oracle 增量日志

增量复制需要读取 Oracle 事务日志。实施前应完成源端检查，包括：

• Oracle 日志模式；
• Redo 和归档日志可访问性；
• 补充日志配置；
• 日志保留时间；
• 归档空间；
• 源端账号权限；
• 迁移期间日志是否可能被提前清理。

日志保留时间需要覆盖：

如果任务需要读取的归档日志已经被清理，增量任务可能无法从原位置继续。

3.  主键或唯一约束是同步前提

NineData 要求，同步对象中的每张表应具有主键或唯一约束。

主键或唯一约束用于：

• 唯一定位更新记录；
• 定位删除记录；
• 避免重试时产生重复数据；
• 处理增量事件；
• 执行差异对比和修复。

因此，迁移前必须生成无主键、无唯一约束表清单。

对于无主键表，应采取以下方式之一：

1. 增加合适的主键；
2. 为确实唯一的字段增加唯一约束；
3. 将该表排除在 NineData 增量复制范围之外；
4. 采用一次性导入或其他经过验证的迁移方式。

4.  准备目标端账号和网络

确认：

• NineData 可以访问 Oracle 和 OceanBase；
• 防火墙、安全组和白名单已放行；
• 源端账号具备日志和数据读取权限；
• 目标端账号具备创建对象或写入数据的权限；
• 目标端磁盘和租户资源充足；
• 目标端没有其他业务或同步任务同时写入。

实际权限按照迁移的实际需求授予，不建议直接授予不必要的全局高权限。

四、Oracle 对象转换怎么做

Oracle 到 OceanBase 的对象转换不能只看表和字段，还要建立完整的对象清单。NineData 预检查会根据当前复制链路、所选对象和任务配置检查部分连接、权限、对象及兼容性问题。预检查未通过的项目必须处理；标记为“警告”的项目需要结合实际业务进行人工确认。

需要盘点的对象

• 表
• 主键和唯一约束
• 普通索引
• 分区表
• 序列
• 视图
• 物化视图
• 同义词
• 触发器
• 存储过程和函数
• Package
• DB Link
• Job
• 用户、角色和权限

对象处理建议

表、字段和索引

重点关注：字段类型、字段长度、数值精度、默认值、NULL 属性、字符长度语义、索引字段顺序、分区键和分区策略。NineData 预检查会识别数据类型不兼容的字段，但字段语义是否等价仍需人工确认。

物化视图

Oracle 和 OceanBase 链路条件下，NineData 复制任务暂时不支持物化视图的复制、创建或持续维护。物化视图需要单独处理：OceanBase Oracle 模式虽然支持物化视图，但刷新方式和查询语句存在兼容限制。源端物化视图应在目标端人工重建或改造。

序列

迁移时需要记录序列当前值、步长和缓存配置。正式切换前应确认 OceanBase 中的序列值不会小于业务已经使用的最大值，否则可能产生主键冲突。

触发器

OceanBase Oracle 模式支持触发器。但在 NineData 增量同步场景下，目标端触发器的触发逻辑会在 NineData 写入数据时被执行。如果触发器产生了额外的数据变更，可能与同步逻辑叠加，造成预期外的结果。迁移前应确认目标端触发器在同步写入场景下是否需要保留或禁用。

存储过程、函数和 Package

OceanBase 兼容大部分 Oracle PL 功能，但不支持条件编译。PL/SQL 对象的兼容性以目标端编译结果为准，编译报错项即需改造的对象清单。

对象分类建议

将盘点结果分为四类：

点击图片可查看完整电子表格

关于结构对比的说明：NineData 结构对比功能暂不支持 Oracle 到 OceanBase Oracle 这条链路，该链路仅支持数据对比和增量对比。因此，对象转换的核验仍需通过预检查结果和人工检查完成。

五、重点数据类型转换

数据类型转换 NineData 结构复制会自动完成映射。实施中需要额外验证的是 OceanBase 明确不支持或行为有差异的类型。

OceanBase 明确不支持的类型

• LONG：OceanBase 不支持，需在迁移前改造为 CLOB
• LONG RAW：OceanBase 不支持，需改造为 BLOB
• NCLOB：OceanBase 不支持在用户表中创建 NCLOB 列。迁移时由 NineData 或 OMS 等工具将 NCLOB 列转换为 CLOB 进行存储和同步。应用侧若涉及 NCLOB 相关函数（如 TO_NCLOB），需要在目标端验证是否可用。

需要验证行为差异的类型

• DATE 范围：Oracle 支持公元前 4712 年至公元 9999 年，OceanBase 仅支持 0001-01-01 至 9999-12-31。存在公元 1 年之前日期的表需要单独评估。
• 空字符串与 NULL：Oracle 中空字符串等于 NULL，OceanBase Oracle 模式的行为与 Oracle 一致——插入空串 '' 时会自动转换为 NULL 存储，查询时需要用 IS NULL 而不是 = ''。但应用 SQL 中的空串比较逻辑仍需用真实数据验证，确认迁移后行为符合预期。

实际兼容性以 NineData 预检查结果为准。

六、使用 NineData 创建迁移任务

第一步：创建数据源

在 NineData 控制台中创建：

• Oracle 源数据源；
• OceanBase Oracle 模式目标数据源。

完成后分别执行连接测试。

第二步：选择复制类型

完整迁移通常选择：

• 结构复制；
• 全量复制；
• 增量复制。

如果目标端结构已经由人工创建，可以根据实际情况不启用结构复制，但必须确认目标端结构与 NineData 写入要求一致。

第三步：设置目标端处理策略

如果目标端已有对象或数据，需要提前决定：

• 使用已有对象；
• 删除并重建对象；
• 清空目标表；
• 保留目标端数据；
• 遇到冲突时报错；
• 使用源端数据覆盖目标端。

生产环境不建议让应用同时写 Oracle 和 OceanBase。双端写入会增加主键冲突、数据覆盖和回退难度。

第四步：选择同步对象

建议按业务域、Schema 或重要程度分批迁移，先从测试库、小规模表和非核心业务开始。

需要明确：

• 源 Schema 到目标 Schema 的映射；
• 是否排除临时表、日志表和历史表；
• 是否进行字段过滤；
• 是否进行行过滤；
• 大表是否单独迁移；
• 无主键表是否已经治理或排除；
• 目标端是否存在同名对象。

第五步：执行预检查

重点处理：

• 日志条件不满足；
• 账号权限不足；
• 无主键或无唯一约束表；
• 目标端对象已存在；
• 字段和数据类型不兼容；
• 目标端空间不足；
• 网络不稳定；
• 对象不在支持范围内。

预检查通过后，再启动正式复制。

七、执行全量复制

全量复制期间，NineData 将 Oracle 中已有数据写入 OceanBase，同时继续处理源端产生的增量变化。

Oracle 侧监控

• CPU；
• IO；
• 活跃会话；
• 归档日志增长；
• 锁等待；
• 业务响应时间；
• 归档空间。

OceanBase 侧监控

• 租户 CPU 和内存；
• 磁盘空间；
• 写入响应时间；
• 租户资源是否达到上限；
• 热点表或热点分区；
• 索引维护压力；
• 唯一键冲突。

NineData 侧监控

• 全量复制进度；
• 复制速率；
• 增量延迟；
• 失败对象；
• 当前执行线程；
• SQL 和提交响应时间；
• 任务日志。

建议先用较低并发测试，再逐步提高复制速度。迁移速度不能以牺牲源库业务稳定性为代价。

八、DML 和 DDL 增量同步

NineData 支持全对象类型的 DML/DDL 增量数据复制。

DML 增量

DML 主要包括：

• INSERT；
• UPDATE；
• DELETE。

NineData 会持续捕获源端变更并写入 OceanBase。主键或唯一约束是稳定定位记录的前提。

DDL 增量

DDL 可能包括：

• 新增字段；
• 删除字段；
• 修改字段；
• 新建或删除索引；
• 修改约束；
• 表结构变化；
• 对象创建或删除。

但 DDL 的“可捕获、可复制”不等于“所有 Oracle DDL 都能在 OceanBase 端完全等价执行”。以下变更仍需在测试环境验证：

• 修改字段类型；
• 修改主键；
• 修改分区；
• 表重命名；
• 字符集变更；
• 复杂视图；
• 触发器；
• 序列；
• Package 和 Job。

生产迁移期间仍建议冻结非必要 DDL。必须执行时，应先确认当前 NineData 链路、Oracle 版本和 OceanBase 版本的兼容性，再检查任务状态和目标端结构。

九、数据一致性校验

数据复制任务运行正常，并不等于源端和目标端已经完全一致。建议分层校验。

1.  对象校验

比较：

• 表数量；
• 字段数量；
• 主键数量；
• 唯一约束数量；
• 索引数量；
• 分区数量；
• 序列和视图数量；
• 对象有效状态。

2.  快速数据校验

检查：

• 表行数；
• 数值字段最大值、最小值和平均值；
• 抽样记录；
• 空值数量；
• 关键业务汇总值。

3.  全量数据对比

对订单、账户、库存、支付和余额等关键表，建议执行全量数据对比。

NineData 数据对比支持配置：

• 对比并发；
• 自动或手动分片；
• 每个分片的记录数；
• 差异明细数量；
• 浮点数精度；
• 大字段是否参与对比；
• 字符串空格处理方式。

4.  增量数据对比

对于增量同步期间产生的新增、更新和删除记录，还应检查：

• 是否存在漏同步；
• 是否存在重复写入；
• 是否存在目标端冲突；
• 字段值是否一致；
• 删除操作是否正确执行。

差异修复 SQL 执行前，需要检查外键、唯一约束、执行顺序和业务影响。

十、应用兼容性测试

迁移前应使用真实或接近真实的业务流量测试：

• JDBC 或其他连接驱动；
• 连接池；
• SQL 语法；
• 绑定变量；
• 分页查询；
• 序列；
• 存储过程；
• 临时表；
• 事务隔离；
• 锁等待；
• 大字段读写；
• 批量写入；
• 执行计划；
• 核心接口响应时间。

建议建立兼容性问题清单：

点击图片可查看完整电子表格

十一、低停机业务切换步骤

全量复制完成、增量延迟为0秒，并不代表可以直接切换。源端只要继续写入，就可能立即产生新事务。

切换前检查

确认：

• 结构复制完成；
• 全量复制完成；
• 增量任务稳定；
• 无失败对象；
• 数据对比通过；
• 核心接口验证通过；
• 序列值已经检查；
• OceanBase 资源充足；
• 应用连接配置已经准备；
• 回退方案已经演练。

正式切换

1. 停止批处理、Job 和消息消费者。
2. 将业务设置为只读，或暂停 Oracle 写入。
3. 等待未提交事务完成。
4. 等待 NineData 增量延迟降至0秒。
5. 执行最终数据对比。
6. 切换应用连接到 OceanBase。
7. 重启或刷新连接池。
8. 执行登录、查询、写入和核心交易测试。
9. 恢复业务写入。
10. 持续观察应用错误率、慢 SQL、锁等待和同步状态。

“低停机”是指迁移和追平期间业务可以持续运行，最终只需要较短的写暂停和连接切换时间，并不代表所有场景都绝对零停机。

十二、回退方案

如果业务切换到 OceanBase 后发现兼容性或性能问题，直接把连接切回 Oracle，可能导致切换期间产生的数据丢失。

回退设计应明确：

• 回退触发条件；
• 回退负责人；
• OceanBase 新数据如何回流；
• 是否建立并验证 OceanBase 到 Oracle 的反向复制；
• 如何避免双向同步循环；
• 回退前是否暂停写入；
• Oracle 如何追平；
• 回退后的数据校验方式；
• 源库保留时间。

NineData 支持 OceanBase 到 Oracle 的反向增量同步，可将业务切换到 OceanBase 后产生的新增数据实时回流至 Oracle，用于业务异常时快速回切。回退链路应在割接前配置并验证。

十三、常见故障处理

增量延迟升高

检查：

• Oracle 是否产生大事务；
• OceanBase 是否写入变慢；
• 网络是否抖动；
• 目标端是否资源不足；
• 是否存在主键或唯一键冲突；
• 是否发生了不兼容 DDL；
• 任务是否被限速。

日志读取位置不可用

如果归档日志已经清理，任务可能无法从原位置继续。应根据缺失时间段和目标端状态，评估重新全量复制、重新同步相关表或使用备份补齐。

目标端出现冲突

确认目标端是否被其他业务写入，检查目标表已有数据及主键策略。不要在未确认数据来源时直接覆盖。

数据对比不一致

建议依次执行：

1. 确认两端是否仍有写入；
2. 重新执行对比；
3. 判断缺失、重复或字段值差异；
4. 查看任务日志；
5. 少量差异使用审核后的修复 SQL；
6. 大范围差异重新同步相关表；
7. 修复后再次校验。

十四、实施交付清单

建议至少准备以下材料：

• 源端和目标端环境清单；
• NineData 账号和权限清单；
• Oracle 日志配置检查表；
• 迁移对象清单；
• 无主键表清单；
• 对象转换清单；
• 数据类型映射表；
• 目标端资源评估；
• NineData 任务配置记录；
• 预检查问题处理记录；
• 数据一致性报告；
• 应用兼容性测试报告；
• 性能压测报告；
• 切换操作手册；
• 回退操作手册；
• 切换后观察记录。

总结

Oracle 到 OceanBase Oracle 模式迁移的关键，不是单纯完成一次数据导入，而是建立完整的复制和验证闭环。

NineData 提供了  Oracle 到 OceanBase Oracle 模式的数据复制链路，并支持结构复制、全量复制以及 DML/DDL 增量数据复制。

实施过程中最需要提前解决的是：

• 无主键表不能直接纳入正式增量同步；
• Oracle 日志和权限必须满足增量复制要求；
• 对象和数据类型需要逐项验证；
• NineData 具备 DDL 增量复制能力，但异构执行仍需验证；
• 增量延迟为0秒后仍应执行短暂写暂停和最终校验；
• 正式切换前必须准备可执行的回退方案。

只有将 NineData 的复制能力与对象治理、应用改造、数据校验和切换演练结合起来，才能完成一套真正可落地的 Oracle 到 OceanBase 迁移方案。

常见问题

Oracle 可以直接迁移到 OceanBase 吗？

可以迁移到 OceanBase Oracle 模式，但需要完成版本、对象、数据类型、应用 SQL 和性能兼容性评估。

NineData 支持 Oracle 到 OceanBase 的增量同步吗？

支持。NineData 支持全量复制和增量复制，并支持全对象类型的 DML/DDL 增量数据复制。具体能力以当前版本文档和预检查结果为准。

无主键表能否通过测试后继续同步？

不建议这样理解。NineData将主键或唯一约束列为同步前提。无主键表应先治理、排除或采用其他经过验证的迁移方式。

迁移期间可以继续写 Oracle 吗？

全量和增量追平期间可以继续提供业务服务。最终切换阶段建议短暂暂停写入，等待增量追平并完成最终校验。

DDL 能否自动从 Oracle 同步到 OceanBase？

NineData 具备 DDL 增量复制能力，但具体 DDL 在 OceanBase Oracle 模式中的执行结果仍取决于对象类型、数据库版本和兼容性。生产环境应先测试，迁移窗口内冻结非必要 DDL。

增量延迟为0秒后能否立即切换？

不建议立即切换。应先暂停写入、等待未提交事务完成、执行最终对比，再切换应用连接并完成业务验证。