31. Creating an exception handler to record the erroneous transactions in a GoldenGate confguration

简单说明：

OGG提供了捕获异常的特性，能够让应用进程遇到故障时捕获该故障，使应用进程不会停机，本篇博文主要测试该特性
依据《11. Setting up a simple GoldenGate replication confguration between two single node databases》
部署试验环境模拟本次实验，将该博文实验步骤全部执行完毕

实验步骤：

1° 源端改写抽取进程和发送进程并重启：

su - oracle
cd /ggs/dirprm
cat>EGGTEST1.prm<<EOF
EXTRACT EGGTEST1
USERID ggs, PASSWORD ggs
EXTTRAIL /ggs/dirdat/st
NOCOMPRESSDELETES
GETUPDATEBEFORES
TABLE SCOTT.EMP;
EOF
cat>PGGTEST1.prm<<EOF
EXTRACT PGGTEST1
USERID ggs, PASSWORD ggs
RMTHOST 192.168.77.11, MGRPORT 8809
RMTTRAIL /ggs/dirdat/rt
GETUPDATEBEFORES
TABLE SCOTT.EMP;
EOF
cd /ggs
echo 'STOP  *'|./ggsci
echo 'START *'|./ggsci

2° 目标端创建记录异常的表：

su - oracle
sqlplus scott/tiger
create table EMP_EXCEPTIONS
(
  EMPNO    NUMBER(4) not null,
  ENAME    VARCHAR2(10),
  JOB      VARCHAR2(9),
  MGR      NUMBER(4),
  HIREDATE DATE,
  SAL      NUMBER(7,2),
  COMM     NUMBER(7,2),
  DEPTNO   NUMBER(2),
  ERRDATE  DATE,
  OPTYPE   VARCHAR2(255),
  DBERRNO  NUMBER,
  DBERRMSG VARCHAR2(4000)
);
exit

3° 目标端改写应用进程并重启：

su - oracle
cd /ggs/dirprm
cat>RGGTEST1.prm<<EOF
REPLICAT RGGTEST1
USERID ggs, PASSWORD ggs
ASSUMETARGETDEFS
REPERROR (DEFAULT, EXCEPTION)
-- 配置捕获进程捕获错误的行为
-- 参数DEFAULT匹配所有错误类型
-- 参数EXCEPTION表示异常处理模块跟进捕获的错误
MAP SCOTT.EMP, TARGET SCOTT.EMP;
INSERTALLRECORDS
-- 该参数将OGG所有的应用行为都转化成INSERT操作
MAP SCOTT.EMP, TARGET SCOTT.EMP_EXCEPTIONS, EXCEPTIONSONLY, &
COLMAP (USEDEFAULTS, ERRDATE = @DATENOW(), &
                      OPTYPE = @GETENV("LASTERR", "OPTYPE"), &
                     DBERRNO = @GETENV("LASTERR", "DBERRNUM"), &
                    DBERRMSG = @GETENV("LASTERR", "DBERRMSG"));
EOF
cd /ggs
echo 'STOP  REPLICAT RGGTEST1'|./ggsci
echo 'START REPLICAT RGGTEST1'|./ggsci

4° 测试验证：

# 目标端操作
su - oracle
sqlplus scott/tiger
DELETE EMP WHERE EMPNO=7902;
COMMIT;
exit

# 源端操作
su - oracle
sqlplus scott/tiger
UPDATE EMP SET SAL=SAL+100 where EMPNO=7902;
COMMIT;
exit

# 目标端验证
sqlplus scott/tiger
select * from EMP_EXCEPTIONS;
exit
# 应用进程并未故障，捕获到异常，测试成功

实验总结：

MAPEXCEPTION method
使用一个表来记录所有复制表的错误信息的模式
记录错误信息的表应该是所有被复制表的超集，包含所有被复制表的所有列
参数配置样例：
  MAP SCOTT.*, TARGET SCOTT.*, &
  MAPEXCEPTION (TARGET SCOTT.ALLEXCEPTIONS,
  COLMAP(USEDEFAULTS, TABLE_NAME = @GETENV("GGENV", "TABLENAME"), &
                         ERRDATE = @DATENOW(), &
                          OPTYPE = @GETENV("LASTERR", "OPTYPE"), &
                         DBERRNO = @GETENV("LASTERR", "DBERRNUM"), &
                        DBERRMSG = @GETENV("LASTERR", "DBERRMSG")));

Handle exceptions with a MACRO
用来保存异常SQL语句的异常捕获模式
可以对每个需要捕获异常的表单独写MAP，捕获到同一个异常捕获表中
也可以定义一个宏来进行通配(错误信息存在ggs.ALLEXCEPTIONS表中)：
  -- 定义一个宏
  EDIT PARAMS EXCEPTION_HANDLER.mac
  MACRO #EXCEPTION_HANDLER
  BEGIN
  , TARGET ggs.ALLEXCEPTIONS
  , COLMAP ( REPLICAT_NAME = @GETENV("GGENVIRONMENT", "GROUPNAME"))
  , TABLE_NAME             = @GETENV ("GGHEADER", "TABLENAME")
  , ERRNO                  = @GETENV ("LASTERR", "DBERRNUM")
  , DBERRMSG               = @GETENV ("LASTERR", "DBERRMSG")
  , OPTYPE                 = @GETENV ("LASTERR", "OPTYPE")
  , ERRTYPE                = @GETENV ("LASTERR", "ERRTYPE")
  , LOGRBA                 = @GETENV ("GGHEADER", "LOGRBA")
  , LOGPOSITION            = @GETENV ("GGHEADER", "LOGPOSITION")
  , COMMITTIMESTAMP        = @GETENV ("GGHEADER", "COMMITTIMESTAMP"))
  , INSERTALLRECORDS
  , EXCEPTIONSONLY;
  END;
  -- 在应用进程中引用该宏
  include ./dirprm/EXCEPTION_HANDLER.mac
  REPERROR (DEFAULT, EXCEPTION)
  MAP SCOTT.EMP, TARGET SCOTT.EMP;
  MAP SCOTT.EMP #EXCEPTION_HANDLER()

  -- 当然也可以将宏的定义直接写在应用进程中
  EDIT PARAMS RGGTEST1
  ...
  MACRO #EXCEPTION_HANDLER
  ...

[TOC]