Oracle GoldenGate: 使用宏

     OGG宏与C语言中的宏一样，提供了函数封装的功能，即可以将一些配置参数整理为一个宏，然后在多个参数文件中共用，针对环境复杂或多个复制点的情况尤其有用。下面我们将介绍如何创建一个宏的库，以及在OGG参数文件中如何使用创建的这个宏 library.
一个宏函数库是宏的集合，宏可以是一个库文件中包含多个宏的定义，或多个库文件，包括不同的宏定义。建议将库文件存放在OGG的dirmac目录下，同时，库文件使用.mac为后缀。这样可以在引用时方便的识别。

下面是一个宏的示例，所有内容存放在一个库文件中：“$OGG_BASE/dirmac/macrolib.mac”.

MACRO #dbconnect
BEGIN
userid gguser, password AACAAAAAAAAAAAHAAIFBOIYAMCGIMARE, encryptkey default
END;

MACRO #bpsettings
BEGIN
STATOPTIONS RESETREPORTSTATS

-- Generate a report every day at 1 minute after midnight.
-- This report will contain the number of operations, by operation
-- type, performed on each table.
REPORT AT 00:01

REPORTROLLOVER AT 00:01
REPORTCOUNT EVERY 60 SECONDS, RATE

-- End of "best practices" section
END;

MACRO #funcsmap
PARAMS (#src_table, #target_table)
BEGIN
   MAP #src_table, TARGET #target_table,
    colmap (usedefaults,
            orders_trans_ts = @GETENV ("GGHEADER", "COMMITTIMESTAMP"),
            trans_rec_loc8tr = @STRCAT (@GETENV ("RECORD", "FILESEQNO"),
                                        @GETENV ("RECORD", "FILERBA")),
            extract_lag_ms = @TOKEN ("TKN-EXTLAG-MSEC"),
            replicat_lag_ms = @GETENV ("LAG", "MSEC"),
            src_db_name = @TOKEN ("TKN-SRC-DBNAME"),
            src_db_version = @TOKEN ("TKN-SRC-DBVERSION"),
            src_txn_csn = @TOKEN ("TKN-TXN-CSN")
     );
END;

所有的宏使用关键“Macro”关键字开始定义，后面是宏的名称，以“#name”定义，宏的内容由“begin...end;”关键字包含，上面的三个宏定义分别是#dbconnect, #bpsettings, 和#funcsmap。其中
#dbconnect宏定义了一个DB连接的语句，使用默认的key进行密码加密；
#bpsettings宏定义了OGG中配置时的一些最佳建议，比如按天或按小时报告复制情况；
#funcsmap宏定义了一个map映射，要注意的是它要求带两个参数来使用；

下面是该宏在一个replicat端的使用：

nolist
include ./dirmac/macrolib.mac
list

replicat rfuncb
#dbconnect ()
#bpsettings ()
sourcedefs ./dirdef/mydefs.defs
discardfile ./dirrpt/rfuncb.dsc, purge
#funcsmap (amer.orders, euro.funcs_test)

当rfuncb投递进程启动时，include语句将加载库文件：./dirmac/macrolib.mac。参数nolist的意思是告诉投递进程不要把后面的执行情况写入到日志文件中，而list参数则是要求后续的执行语句都要写日志。
如果本参数文件中没有list语句，则整个投递进程将不会有任何日志输出到文件中。
当投递进程读取这个replicat参数文件时，它会将引用的宏替换为库文件中的语句定义，因此“#dbconnect ()”，“#bpsettings ()” 和 “#funcsmap (amer.orders, euro.funcs_test)”都会被替换为相应的语句。

“#funcsmap”宏使用了两个参数，分别代表源表和目标表。PARAMS关键字是告诉使用人员，这个宏需要有参数才能运行。针对参数的使用，有以下几点注意事项：

• 参数名不区分大小写；
• 参数名中不能使用引号；
• 参数在宏定义中不是必须的；
• 一个宏最多可以有99个参数，所有参数的长度不能超过9999字节；
• 所有参数都必须在PARAMS语句中定义，当调用宏时，所有参数都必须赋值。

小结
OGG宏在灵活运用和配置OGG参数时是个不错的技巧，特别是针对多个配置文件和复杂环境时，可以在一个文件中定义常用的一组操作，然后在所有环境中使用，降低运维的复杂性。