『OGG 03』Win7 配置 Oracle GoldenGate 一次性成功（包括Adapter Java）

安装Oracle：

安装 Oracle_11g 32位【Oracle 32位的话，OGG 也必须是 32位，否则会有0xc000007b无法正常启动 错误】

安装目录为 D:\oracle\product\11.1.0\db1 【这个目录要设置为 环境变量 ORACLEHOME】

设置环境变量：

JAVAHOME C:\Program Files\Java\jdk1.8.0121

ORACLEHOME D:\oracle\product\11.1.0\db1

ORACLE_SID ORCL

验证环境变量：

获取 ORACLESID ： 打开 SQLPlus，登录 SYS 账户，执行 select instancename from v$instance;

获取 ORACLEHOME ： 查找 Oracle安装目录，这个目录有个特征：有一个子目录名叫 RDBMS。就是说： %ORACLEHOME%\RDBMS\ 这个路径要能正常打开即为配置成功。

Oracle数据库创建用户，授予 DBA权限

略（参见 《__Win7 配置 Oracle GoldenGate 踩坑指南》中的配置）

Oracle启用日志存档模式

略（参见 《__Win7 配置 Oracle GoldenGate 踩坑指南》中的配置）

安装 OGG

安装 32位的 OGG 11.1，用于数据库之间的 同步 （和 Oracle 数据库版本、位数一致）

安装 64位的 OGG Adapter Java 12，用于Java程序适配（11.1 的版本会崩溃）

安装 64位的 JDK 1.8 （OGG Adapter Java 因为是64位的）

http://www.oracle.com/technetwork/cn/middleware/goldengate/downloads/index.html

拖到页面最后面

搜索 需要下载的 OGG

单击“购物车”，选择需要下载的版本

点击 右下角的 “下载”，把OGG文件 放到 D盘

先说一下目标：

Oracle 数据库中 有 两个用户（结构） ADMIN 和

每个用户（结构） 都有结构完全一样的 表： TB_TEST

目标1：我们要配置OGG，当 ADMIN.TBTEST 的数据变化时，ROOT.TBTEST 能自动同步这种变化（实现容灾备份）

目标2：我们要配置OGG，当 ADMIN.TB_TEST 的数据变化时，Java程序可以捕获到这种变化。

部署 OGG

上面4个目录的意思：

• dirdat 目标端的 Trail 文件目录

• s 源端（ADMIN.TB_TEST 的OGG服务，数据抽取）

• t 目标端（ROOT.TB_TEST 的 OGG服务，数据备份）

• javaue 目标端（从 D:\dirdat\ 中，将 Trail文件变化 交给Java程序处理）

编辑配置

源端配置：一个管理服务、两个抽取进程

ext1.prm

extract ext1
userid admin,password oracle
rmthost 127.0.0.1, mgrport 7909
rmttrail D:/ogg/dirdat/r1  

grouptransops 1
maxtransops 1
flushsecs 0
eofdelay 0

dynamicresolution
gettruncates
table admin.*;

ext2

extract ext2
userid admin,password oracle
rmthost 127.0.0.1, mgrport 7909
rmttrail D:/ogg/dirdat/r2 

grouptransops 1
maxtransops 1
flushsecs 0
eofdelay 0

dynamicresolution
gettruncates
table admin.*;

mgr.prm

PORT 7809
DYNAMICPORTLIST 7840-7850

目标端配置：一个管理服务、一个同步进程

rep1.prm

replicat rep1
userid root,password oracle
assumetargetdefs
reperror default,discard

grouptransops 1
maxtransops 1

discardfile D:/ogg/dirdat/repsz.dsc,append
map admin.*, target root.*;

mgr.prm

PORT 7909
DYNAMICPORTLIST 7940-7950

Javaue配置：一个管理服务、一个Javaue进程

javaue.prm

Extract JAVAUE
SetEnv (GGS_USEREXIT_CONF = "dirprm/javaue.properties")
SourceDefs dirprm/source.def

--getEnv (JAVA_HOME)
--getEnv (LD_LIBRARY_PATH_12)  --边境变量 LD_LIBRARY_PATH_12 指向的是 D:\ogg\javaue12\ggjava\resources\lib
--getEnv (PATH)

CUserExit ggjava_ue.dll CUSEREXIT PassThru IncludeUpdateBefores
GetUpdateBefores

-- NoCompressDeletes
-- NoCompressUpdates

Table ADMIN.*;

javaue.properties

### java.naming.provider.url=tcp://localhost:61616
### java.naming.factory.initial=org.apache.activemq.jndi.ActiveMQInitialContextFactory

gg.handlerlist=sample
gg.handler.sample.type=sample.SampleHandler
# com.goldengate.atg.datasource.handler.ConsoleHandler

goldengate.userexit.timestamp=utc
goldengate.userexit.nochkpt=true
goldengate.userexit.writers=javawriter

goldengate.log.logname=cuserexit
goldengate.log.level=INFO
goldengate.log.tofile=true

javawriter.stats.display=TRUE
javawriter.stats.full=TRUE

# javaue.prm 我们之所以注释掉了 getEnv (LD_LIBRARY_PATH_12) 是因为：我们手动把路径配置在了下面代码中
javawriter.bootoptions=-Djava.class.path=.;dirprm;ggjava/resources/classes;ggjava/resources/lib;ggjava/ggjava.jar;dirprm/fastjson-1.2.7.jar;dirprm/custom.jar -Dlog4j.configuration=log4j.properties

mgr.prm

PORT 7509
DYNAMICPORTLIST 7540-7550

生成 source.def 文件（Javaue 运行需要）

在 D:\Temp\创建一个 source.prm 文件

D:\Temp\source.prm

defsfile D:\Temp\source.def, purge
userid admin,password oracle
table admin.*;

运行命令行：

用Eclipse 编写Java插件：

打开 Eclipse 新建“Java项目”custom12，新建一个包 sample，新建一个类 SampleHandler.java 将如下代码 复制到 SampleHandler.java 中

package sample;
import java.io.*;
import java.util.ArrayList;
import java.util.List;
import java.util.Set;

//这是 OGG 11 的 import
//import com.goldengate.atg.datasource.AbstractHandler;
//import com.goldengate.atg.datasource.DsConfiguration;
//import com.goldengate.atg.datasource.DsEvent;
//import com.goldengate.atg.datasource.GGDataSource.Status;
//import com.goldengate.atg.datasource.handler.*;
//import com.goldengate.atg.datasource.meta.DsMetaData;
//import com.goldengate.atg.datasource.test.DsTestUtils.Logger;
//import com.goldengate.atg.datasource.meta.*;
//import com.goldengate.atg.datasource.*;

//这是 OGG 12 的 import
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import oracle.goldengate.datasource.AbstractHandler;
import oracle.goldengate.datasource.DsColumn;
import oracle.goldengate.datasource.DsConfiguration;
import oracle.goldengate.datasource.DsEvent;
import oracle.goldengate.datasource.DsOperation;
import oracle.goldengate.datasource.DsOperation.OpType;
import oracle.goldengate.datasource.DsTransaction;
import oracle.goldengate.datasource.GGTranID;
import oracle.goldengate.datasource.meta.ColumnMetaData;
import oracle.goldengate.datasource.meta.DsMetaData;
import oracle.goldengate.datasource.meta.TableMetaData;
import oracle.goldengate.datasource.meta.TableName;
import oracle.goldengate.datasource.GGDataSource.Status;

public class SampleHandler extends AbstractHandler {
    //OGG 11 和 OGG 12 的 日志好像不一样， OGG 12 似乎要写 LoggerFactory.getLogger(SampleHandler.class);
    //private final Logger logger = Log4jLogger.getLogger(SampleHandler.class);
    private final Logger logger = LoggerFactory.getLogger(SampleHandler.class);

    @Override
    public void init(DsConfiguration conf, DsMetaData metaData) {
        super.init(conf,  metaData);
        logger.info("init!");
        WriteStringToFile("D:\\SampleHandler.log", "SampleHandler.init(*)");
    }
    @Override
    public Status transactionCommit(DsEvent e, DsTransaction tx) {

//      DsMetaData meta = e.getMetaData();
//      //System.out.println(meta);
//
//      Set<TableName> tableNames = meta.getTableNames();
//      for(TableName tableName : tableNames){
//          String tableStr = "";
//          tableStr = tableStr + tableName+" : ";
//
//          TableMetaData metaData = meta.getTableMetaData(tableName);
//          ArrayList<ColumnMetaData> columns = metaData.getColumnMetaData();
//          for(ColumnMetaData column : columns){
//              tableStr = tableStr + "\r\n   " + column.getColumnName() + " | "+column.getDataType().toString();
//          }
//
//          System.out.println(tableStr+"\r\n");
//          //System.out.println(metaData);
//      }
//
//        //GGTranID tranId = e.getTargetCheckpointInfo();
//        //System.out.println(tranId);
//
//      System.out.println(tx.getSize());
//      System.out.println(tx.getTotalOps());
//      System.out.println(tx.getReadTime());
//      System.out.println(tx.getTransactionBeginTime());
//
//
//      Object eventSource = e.getEventSource();
//      System.out.println(eventSource);
//
//      DsOperation lastOp = tx.getLastOperation();
//      System.out.println(lastOp);
//
//
//      List<DsOperation> listOp = tx.getOperations();
//      System.out.println(listOp.size());
//      //System.out.println(listOp.get(0).getColumn(0).getBeforeValue());
//      for(DsOperation op : listOp){
//          System.out.println(op.getTableName());
//      }

        Status  superResult = super.transactionCommit(e, tx);
        logger.info("transactionCommit!");
        WriteStringToFile("D:\\SampleHandler.log", "SampleHandler.transactionCommit(*) => "+superResult);
        return superResult;
    }

    @Override
    public Status operationAdded(DsEvent e, DsTransaction tx, DsOperation dsOperation) {

        DsMetaData meta = e.getMetaData();
        //System.out.println(meta);

//      Set<TableName> tableNames = meta.getTableNames();
//      for(TableName tableName : tableNames){
//          String tableStr = "";
//          tableStr = tableStr + tableName+" : ";
//
//          TableMetaData metaData = meta.getTableMetaData(tableName);
//          ArrayList<ColumnMetaData> columns = metaData.getColumnMetaData();
//          for(ColumnMetaData column : columns){
//              tableStr = tableStr + "\r\n   " + column.getColumnName() + " | "+column.getDataType().toString();
//          }
//
//          System.out.println(tableStr+"\r\n");
//          //System.out.println(metaData);
//      }

        System.out.println("---------------------------------------");

        OpType opType = dsOperation.getOperationType();
        System.out.println(opType);

        TableName tableName = dsOperation.getTableName();
        System.out.println(tableName.getFullName());

        TableMetaData metaData = meta.getTableMetaData(tableName);
        ArrayList<ColumnMetaData> columnMetas = metaData.getColumnMetaData();
        List<DsColumn> columns = dsOperation.getColumns();
        for(int i=0; i<columnMetas.size(); i++){
            ColumnMetaData columnMeta = columnMetas.get(i);
            DsColumn column = columns.get(i);
            System.out.println("    " + columnMeta.getColumnName() + "\t | \t"+ column.getAfterValue() + (column.isChanged()? "\t >>> \t" +column.getAfterValue():""));
        }

        System.out.println("---------------------------------------");

        Status superResult = super.operationAdded(e, tx, dsOperation);
        logger.info("operationAdded!");
        WriteStringToFile("D:\\SampleHandler.log", "SampleHandler.operationAdded(*) => "+superResult);
        return superResult;
    }

    //@Override
    //public DataSourceListener.State   getState() {
    //  return super.getState();
    //}

    @Override
    public void destroy() {
        super.destroy();
        WriteStringToFile("D:\\SampleHandler.log", "SampleHandler.destroy(*)");
        logger.info("destroy!");
    }
    @Override
    public String reportStatus() {
        String superResult = "OK"; //super.reportStatus(); 调用父类函数,程序就会崩溃。
        WriteStringToFile("D:\\SampleHandler.log", "SampleHandler.reportStatus(*) => "+superResult);
        return superResult;
        //return "status report...===";
    }  

    public static void WriteStringToFile(String filePath, String text) {
        try {
            System.out.println("AAAAAAAAAAAAAAAAA :" + text);
            FileWriter writer = new FileWriter(filePath, true);
            writer.write("\r\n"+text);
            writer.close();
        } catch (IOException e) {
            //e.printStackTrace();
            System.out.println(e.getMessage());
        }
    }     

}

*下面截图的包名 sample 错写成了 simple *

添加外部jar包引用，具体包括

ggjava\ggjava.jar

ggjava\resources\lib 目录下的全部 jar 包

至此，OGG整个配置环节，需要准备的 文件都已经准备完成，接下来准备启动 OGG。

启动源端OGG：

启动源端OGG：

进入 D:\ogg\s\ 目录，双击 ggsci.exe，运行如下命令

> create subdirs

> dblogin userid admin,password oracle

> add trandata admin.*

> add extract ext1, tranlog, begin now

> add rmttrail D:/ogg/dirdat/r1 extract ext1

> add extract ext2, tranlog, begin now

> add rmttrail D:/ogg/dirdat/r2 extract ext2

> start mgr

> start ext1

> start ext2

启动目标端OGG：

进入 D:\ogg\t\ 目录，双击 ggsci.exe，运行如下命令

> create subdirs

> add replicat rep1 exttrail D:/ogg/dirdat/r1, nodbcheckpoint

> start mgr

> start rep1

验证 源端>目标端 的同步：

如果 ext1 ext2 因为 rep1 没有启动而自动停止，则需要 重新启动一次 源端的 ext1 ext2

我们向 ADMIN.TBTEST 插入一行记录，理论上 ROOT.TBTEST 也会对应的 同步一行记录

启动OGG Javaue：

进入 D:\ogg\javaue12\ 目录，双击 ggsci.exe，运行如下命令

最后的话：

至此：OGG（Oracle GoldenGate）同步配置 和 Adaper Java 程序适配 已经全部完成。

建议：严格按照上面的步骤，所有名称 都尽量不要变化 —— 先把第一次 全部跑通。

等全部跑通后，你再试着修改 其中的 各个部分的名称 —— 对照 prm 文件配置，试着理解 OGG配置原理。

如果配置过程中，出现任何诡异BUG，

欢迎参考

《__Win7 配置 Oracle GoldenGate 踩坑指南》 和 《__Win7 配置 Oracle GoldenGate Adapter Java 踩坑指南》 两篇踩坑文章。

—— 事实上，OGG配置的坑很多，总有一款适合你，两篇《踩坑指南》 你逃不掉的。

舒小龙 2018-06-04