27. Adding custom felds to a replicated record using SQLEXEC

简单说明：

本篇博文实验使用OGG的SQLEXEC参数实现在复制时执行SQL生成数据并插入到目标端的功能
依据《11. Setting up a simple GoldenGate replication confguration between two single node databases》
部署试验环境模拟本次实验，将该博文实验步骤全部执行完毕

实验步骤：

1° 修改目标端表结构，用于存储SQLEXEC参数生成的信息：

su - oracle
cd /ggs
echo 'STOP REPLICAT RGGTEST1'|./ggsci
echo 'ALTER TABLE EMP ADD AVG_SAL number;'|sqlplus scott/tiger

2° 源端抽取和发送进程配置保持不变，进程保持启动状态

3° 目标端改写应用进程配置文件，重启应用进程：

su - oracle
cd /ggs/dirprm
cat>RGGTEST1.prm<<EOF
REPLICAT RGGTEST1
USERID ggs, PASSWORD ggs
DISCARDFILE /ggs/dirrpt/RGGTEST1.dsc,append,MEGABYTES 500
ASSUMETARGETDEFS
MAP SCOTT.EMP, TARGET SCOTT.EMP, &
SQLEXEC (ID lookavg, &
QUERY "SELECT AVG(SAL) avgsal
         FROM SCOTT.EMP
        WHERE DEPTNO = (SELECT DEPTNO FROM SCOTT.EMP WHERE EMPNO = :EMP_NO)", &
PARAMS (EMP_NO = EMPNO)), &
COLMAP (USEDEFAULTS, AVG_SAL = @GETVAL(lookavg.avgsal));
-- 在MAP步骤中使用SQLEXEC参数，格式如下：
-- MAP SCOTT.EMP, TARGET SCOTT.EMP, &
-- SQLEXEC(ID key, QUERY " ..." PARAMS (xx = xx)), &
-- COLMAP (USEDEFAULTS, AVG_SAL = @GETVAL(key.col);
-- 使用&符号作为换行连接符，连接了：
-- MAP ..., TARGET ..., SQLEXEC(ID ..., QUERY "...", PARAMS(...), COLMAP(...));
-- 在QUERY子句中的SQL使用双引号引起来，该SQL换行不必再加&符号换行连接符
-- 在该SQL中，所有表名都需要加对象名，因为该SQL最终以ggs用户执行
-- 该SQL计算的平均工资是记录插入前的平均工资
EOF
cd /ggs
echo 'START  REPLICAT RGGTEST1'|./ggsci
echo 'STATUS REPLICAT RGGTEST1'|./ggsci

4° 测试验证：

# 源端操作
su - oracle
sqlplus scott/tiger
insert into emp values(9998,'vincent','vincent',7788,sysdate,100,100,10);
commit;
exit

# 目标端验证
sqlplus scott/tiger
select EMPNO,AVG_SAL from emp;
exit

实验总结：

本实验不需要defgen支持
本实验涉及的SQL相对简单，较为复杂的SQL未实验成功，找不到原因

使用SQLEXEC能够在复制的时候执行一个SQL
使用SQLEXEC能够在复制的时候执行一个存储过程
使用SQLEXEC能够在全局执行SQL或存储过程

Running a stored procedure with SQLEXEC
# 目标端创建存储过程：
su - oracle
sqlplus ggs/ggs
CREATE PROCEDURE AVG_SAL(DEPT_NO IN NUMBER, AVGSAL OUT NUMBER) IS
BEGIN
  SELECT AVG(SAL) INTO AVGSAL
    FROM SCOTT.EMP
   WHERE DEPTNO = DEPT_NO;
END;
/
exit
# 目标端修改应用进程配置：
cd /ggs/dirprm
cat>RGGTEST1.prm<<EOF
REPLICAT RGGTEST1
USERID ggs, PASSWORD ggs
DISCARDFILE /ggs/dirrpt/RGGTEST1.dsc,append,MEGABYTES 500
ASSUMETARGETDEFS
MAP SCOTT.EMP, TARGET SCOTT.EMP, &
SQLEXEC (ID AVG_SAL, SPNAME AVG_SAL, &
PARAMS (DEPT_NO = DEPTNO)), &
COLMAP (USEDEFAULTS, AVG_SAL = @GETVAL(AVG_SAL.AVGSAL));
EOF
cd /ggs
echo 'STOP   REPLICAT RGGTEST1'|./ggsci
echo 'START  REPLICAT RGGTEST1'|./ggsci
echo 'STATUS REPLICAT RGGTEST1'|./ggsci
# 源端插入数据进行验证

Running a global SQL statement/procedure
如果要在全局模式下执行SQL或者存储过程
则将该语句写在MAP语句之外，如：
  MAP SCOTT.EMP, TARGET SCOTT.EMP;
  SQLEXEC "call generate_end_of_day_reports()";
  -- 使用calL命令执行存储过程

[TOC]