使用Debezium迁移无主键Oracle表时如何解决undo_retention错误？

开发者阿泽

2026-6-12

解决Debezium Oracle无主键大表同步的ORA-01555及SCN读取失败问题

针对数亿行无主键大表的全量快照超时、UNDO空间不足导致的ORA-01555和SCN读取失败问题，以下是几个可落地的解决方案：

一、优化全量快照扫描速度，缩短UNDO占用时间

核心思路是减少快照阶段的表扫描时长，避免UNDO数据被过早覆盖：

调大快照阶段的批量读取参数：在Debezium连接器配置中，单独设置快照专属的批量大小，同时调大常规fetch size：
```
snapshot.fetch.size=20000
fetch.size=10000
```
数值可根据Oracle数据库的内存配置调整，越大单次读取的数据越多，减少数据库交互次数。
自定义分批次快照查询：如果表中有可用于范围拆分的字段（如创建时间、分区键，即使非主键），用query.snapshot.select.statement.overrides指定分段查询语句，把全表拆成多个小批次扫描：
```
query.snapshot.select.statement.overrides=YOUR_TABLE_NAME:SELECT * FROM YOUR_TABLE_NAME WHERE CREATE_TIME BETWEEN TO_DATE('2020-01-01', 'YYYY-MM-DD') AND TO_DATE('2021-01-01', 'YYYY-MM-DD')
```
可多次运行连接器，每次调整时间范围，完成全量同步后再切换到增量捕获。

临时添加辅助索引：针对用于拆分的范围字段临时创建索引，大幅提升扫描速度，完成快照后删除索引：

CREATE INDEX IDX_TMP_YOUR_TABLE_CREATE_TIME ON YOUR_TABLE_NAME(CREATE_TIME);
-- 快照完成后删除
DROP INDEX IDX_TMP_YOUR_TABLE_CREATE_TIME;

仅调大UNDO_RETENTION不够，需结合UNDO表空间的扩展配置：

设置UNDO表空间自动扩展：确保UNDO空间能随需求增长，避免固定大小导致提前耗尽：
```
ALTER TABLESPACE UNDO_TABLESPACE AUTOEXTEND ON NEXT 10G MAXSIZE 150G;
```
数值根据实际存储资源调整。
启用UNDO保留保障：强制Oracle不删除未满足UNDO_RETENTION时长的UNDO数据，避免快照过程中数据被覆盖：
```
ALTER TABLESPACE UNDO_TABLESPACE RETENTION GUARANTEE;
```
注意：该参数可能导致DML操作在UNDO空间满时失败，建议在快照完成后关闭：
```
ALTER TABLESPACE UNDO_TABLESPACE RETENTION NOGUARANTEE;
```

绕过Debezium的全量快照机制，手动完成全量同步后再开启增量捕获：

记录当前SCN：在Oracle中执行以下语句获取当前数据库SCN，用于后续增量同步的起点：
```
SELECT CURRENT_SCN FROM V$DATABASE;
```

手动导出全量数据：用Oracle的expdp工具并行导出表数据，提升导出速度：

expdp username/password@orcl schemas=YOUR_SCHEMA tables=YOUR_TABLE_NAME parallel=8 dumpfile=table_dump_%U.dmp logfile=table_dump.log

将数据导入Kafka：编写脚本或使用工具（如kafka-console-producer）将导出的数据转换为Kafka消息格式，写入对应topic。
配置Debezium增量捕获：修改连接器配置，跳过全量快照，从记录的SCN开始捕获增量：
```
snapshot.mode=never
start.scn=123456789 -- 替换为之前记录的SCN值
```

如果有Oracle只读副本，将Debezium连接器指向副本执行全量快照：

内容的提问来源于stack exchange，提问作者HighQuality