26. Adding custom felds for a replicated record using tokens

简单说明：

本篇博文实验使用OGG的tokens参数增加抽取信息，并将这些信息同步到目标端
依据《11. Setting up a simple GoldenGate replication confguration between two single node databases》
部署试验环境模拟本次实验，将该博文实验步骤全部执行完毕

实验步骤：

1° 修改目标端表结构，用于存储tokens参数增加的信息：

su - oracle
cd /ggs
echo 'STOP REPLICAT RGGTEST1'|./ggsci
echo 'ALTER TABLE EMP ADD ADDINFO varchar2(255);'|sqlplus scott/tiger

2° 源端改写抽取进程配置文件，重启抽取进程：

su - oracle
cd /ggs/dirprm
cat>EGGTEST1.prm<<EOF
EXTRACT EGGTEST1
USERID ggs, PASSWORD ggs
EXTTRAIL /ggs/dirdat/st
TABLE SCOTT.EMP, TOKENS (TK_DBNAME = @GETENV("DBENVIRONMENT","DBNAME"));
-- 抽取EMP表，使用TOKENS参数生成TK_ORIGIN信息，该信息对应DBNAME
EOF
cd /ggs
echo 'STOP   EXTRACT EGGTEST1'|./ggsci
echo 'START  EXTRACT EGGTEST1'|./ggsci
echo 'STATUS EXTRACT EGGTEST1'|./ggsci

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, COLMAP(USEDEFAULTS, ADDINFO = @TOKEN ("TK_DBNAME"));
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
col ADDINFO for a10
select EMPNO,ADDINFO from emp;
exit

实验总结：

本实验不需要defgen配置支持

本实验在抽取进程抽取的时候使用TOKEN子句
  TOKEN (TK_DBNAME = @GETENV("DBENVIRONMENT","DBNAME"))
  在GETENV环境变量中获取DBNAME，存入TK_DBNAME

本实验在应用进程应用的时候使用COLMAP子句做列映射
  COLMAP(USEDEFAULTS, ADDINFO = @TOKEN ("TK_DBNAME"))
  将目标端表新增列ADDINFO和TK_DBNAME关联起来

抽取进程使用了 TABLE SCOTT.EMP 对EMP表单独做抽取配置
不能再使用诸如 TABLE SCOTT.* 之类的包含EMP表的语句了
这一类特殊复制建议为这些表单独创建抽取发送应用进程组

一些经常使用的附加信息的生成方式：
Name of OS User:               @GETENV ("GGENVIRONMENT","OSUSERNAME")
Process Group Name:            @GETENV ("GGENVIRONMENT", "GROUPNAME")
Process Group Type:            @GETENV ("GGENVIRONMENT", "GROUPTYPE")
Hostname:                      @GETENV ("GGENVIRONMENT","HOSTNAME")
Database name:                 @GETENV ("DBENVIRONMENT","DBNAME")
Database Username:             @GETENV ("DBENVIRONMENT","DBUSER")
Record Commit Time:            @GETENV ("GGHEADER","COMMITTIMESTAMP")
Update Before/After Indicator: @GETENV ("GGHEADER","BEFOREAFTERINDICATOR")
Table Name:                    @GETENV ("GGHEADER", "TABLENAME")
Archive Log Sequence:          @GETENV ("GGHEADER", "LOGRBA")
Archive Log Position In file:  @GETENV ("GGHEADER", "LOGPOSITION")
Database Error Number:         @GETENV ("LASTERR", "DBERRNUM")
Database Error Message:        @GETENV ("LASTERR", "DBERRMSG")
GoldenGate Operation Type:     @GETENV ("GGHEADER", "OPTYPE")
GoldenGate Error Type:         @GETENV ("LASTERR", "ERRTYPE")

[TOC]