Oracle GoldenGate在源端捕获数据后，并不是只能原封不动地把整张表搬过去。通过在Extract的TABLE参数和Replicat的MAP参数中配置过滤与映射规则，可以实现只同步满足条件的记录、只复制部分字段、在目标端完成字段重命名与数据转换等精细化控制。本文将围绕过滤条件的编写、字段映射的几种方式以及常见的排错思路展开。
一、过滤规则的基本写法与执行位置
GoldenGate的过滤分为两个层级：Extract端的TABLE过滤和Replicat端的MAP过滤。前者可以在源头减少抽取的数据量，降低传输压力；后者则在目标端灵活控制落库内容。过滤的位置越靠前，整体链路的负载越低，所以能放在Extract端做的过滤尽量不要推迟到Replicat。
过滤通过FILTER子句实现，语法上支持比较运算符、逻辑运算符和GoldenGate内置的列函数。下面是一个典型示例，只抽取订单状态为已支付且金额大于100的记录：
TABLE SCOTT.ORDERS, & FILTER (ON UPDATE, STATUS = 'PAID' AND AMOUNT > 100);
其中ON UPDATE表示该过滤条件只在更新操作时生效，类似的还有ON INSERT和ON DELETE。如果不指定操作类型，FILTER默认对所有DML操作生效。需要注意的是，FILTER子句中引用列名时大小写敏感，Oracle中列名默认大写，写成小写可能导致过滤失效并在日志中报列找不到的错误。
另一种轻量级做法是使用WHERE子句，例如TABLE SCOTT.ORDERS, WHERE (AMOUNT > 0)。WHERE与FILTER的区别在于：WHERE只能基于列值做简单比较，不支持列函数和Token，而FILTER功能更全面。对于需要排除而不是筛选的场景，可以在Replicat端用参数跳过不需要的表，或者配合@STREQ函数实现反向逻辑。
二、通配符与Token在过滤中的应用
当需要同步大量结构相似的表时，逐表写规则既繁琐又容易遗漏。GoldenGate支持通配符匹配，例如TABLE SCOTT.EMP_*会匹配所有以EMP_开头的表，MAP SCOTT.*, TARGET TGTTAB.*则实现了Schema级别的整体映射。通配符规则可以大幅减少参数文件的篇幅，配合后续的排除规则，维护成本远低于逐表罗列。
Token是GoldenGate提供的环境变量机制，可以在过滤条件中引用系统信息。常用的方式是通过@GETENV函数获取事务环境值，例如只想同步来自特定用户的事务：
TABLE SCOTT.ORDERS, &
FILTER (@GETENV('TRANSACTION','USERID') = 'ETL_USER');
除了内置Token，还可以在表级定义自定义Token，把抽取时间、提交序号等信息带入目标端，常用于数据审计场景。Token的取值在Replicat端通过@TOKEN函数读取，配合映射规则可以填充额外的审计列，这种方式在数据迁移需要保留血缘信息时非常实用。
使用通配符加过滤还有一个技巧：先写通配的宽泛规则，再针对个别表写更具体的例外规则。GoldenGate按参数文件中的顺序匹配规则，命中即止，因此把具体规则放在通配规则之前，可以实现大范围同步加少量例外的效果，结构清晰且便于后续扩展。
三、字段映射的三种典型方式
第一种是隐式映射。当源表和目标表字段名与顺序一致时，GoldenGate自动完成映射，无需额外配置。这种情况多见于同构数据库之间的直接复制，例如Oracle到Oracle的容灾场景，参数最简洁，维护成本最低。
第二种是COLMATCH，用于批量处理字段名的差异。比如源库统一用CREATE_TIME而目标库统一用CRT_TM，一条COLMATCH可以作用于所有表：
COLMATCH NAMES CREATE_TIME CRT_TM MAP SCOTT.*, TARGET TGTTAB.*;
COLMATCH适合字段只是改名而类型不变的场景，配置简洁且对通配符规则同样生效，是Schema级批量迁移的首选方案。它的局限在于只能处理名称对应关系，无法做任何值级别的转换。
第三种是COLMAP，提供最细粒度的控制，可以显式声明每个目标字段取什么值，支持表达式和列函数。典型场景包括字段裁剪、类型转换、默认值填充：
MAP SCOTT.ORDERS, TARGET TGTTAB.ORDERS_NEW,
COLMAP (USEDEFAULTS,
ORDER_ID = ORDER_ID,
PAY_STATUS = @IF(@STREQ(ST='PAID'), 'F', 'T'),
SYNC_TIME = @DATENOW());
USEDEFAULTS表示未被显式列出的字段按同名自动匹配，之后再对个别字段做覆盖式定义。@IF与@STREQ组合实现了状态码翻译，@DATENOW则写入当前时间。需要注意COLMAP中等号左边是目标字段、右边是来源表达式，方向写反是新手最常见的错误之一。此外，若源端某个被引用的列不存在，需要在COLMAP前确保该列已被抽取，否则Replicat会报找不到列的错误。
四、常见问题与排错思路
配置过滤后最典型的问题是数据不完整。排查时应先看Replicat的丢弃文件，被过滤条件拒收或映射失败的记录会连同原因写入其中，这是定位过滤逻辑错误的第一手资料。可以在参数中通过DISCARDFILE指定丢弃文件路径和追加模式，避免文件写满导致进程异常。
其次是统计信息确认。使用GGSCI中的STATS EXTRACT和STATS REPLICAT命令，可以看到每个表的抽取、过滤、插入的记录数。如果抽取量和过滤量对得上而目标端缺失，问题多半出在MAP规则或目标端约束上；如果抽取量本身就偏少，则要检查TABLE参数的过滤条件是否过严。
最后要注意初始装载与增量过滤的一致性。如果初始数据的过滤逻辑与增量TABLE规则不一致，会出现存量与增量数据口径不匹配的问题。建议把过滤条件集中管理，在初始装载和持续复制时复用同一份定义，保证整个生命周期内数据口径统一。掌握这些过滤与映射技巧后，GoldenGate就不再只是一个搬运工具，而是一条可编程的数据加工管道。
Oracle GoldenGate数据过滤字段映射修改时间：2026-08-31 03:26:52