synjq/oragent repository overview

⁠Oragent

Oragent 是九桥同步自主研发的一款 Oracle 数据库日志解析工具，它通过逆向工程 Oracle Redo 的二进制内容，解析出 Oracle 数据库所执行的相应 SQL 语句，并以数据流的形式，提供给下游数据消费者。

⁠开始使用

⁠前置条件

• 在运行 Oracle 数据库的宿主机上，需安装完整的 Docker 引擎 (>= 20)

• 在源端 Oracle 以 sys 用户执行以下 .sql 脚本：

  create or replace view XKCCLE as select * from sys.x$kccle;
  create or replace view XKCCCP as select * from sys.x$kcccp;
  create or replace view ORAGENT_XKSPPI as select * from X$KSPPI;
  create or replace view ORAGENT_XKSPPSV as select * from X$KSPPSV;
  alter database force logging;
  alter database add supplemental log data;
  create user oragent1 identified by oragent1;
  create role oragent_role identified by oragent_role;
  grant connect,lock any table,select any table,select any dictionary,alter system,execute any type to oragent_role,oragent1;
  grant oragent_role to oragent1;
  grant dba to oragent1;
  grant execute on dbms_flashback to oragent_role,oragent1;
  alter user  oragent1 quota 2m on users;
  create table oragent1.oragenttemp (f1 int);
  

  Copy

⁠第一步：拉取 Docker 镜像

docker pull synjq/oragent:latest

⁠第二步：启动 Oragent 容器

docker run -d \
    --name oragent \
    -e ORACLE_VERSION=<your_oracle_database_version> \
    -e ORACLE_HOME=<your_oracle_home> \
    -e WEB_LOGIN=sys/<your_sys_password>@<host>:<port>/<sid> \
    -e SRC_LOGIN=oragent1/oragent1@<host>:<port>/<sid> \
    -p 8303:8303 \
    -v <your_oracle_installation_path>:/u01  \
    synjq/oragent:latest

⁠运行参数

Oragent 支持的运行时参数如下：

• --name：容器的名字
• -p：映射的端口，暴露的端口为 8303
• -e ORACLE_VERSION：Oracle 数据版本 10g|11g|12c（12c 以上版本统一使用 12c 传入）
• -e ORACLE_HOME：Oracle 宿主机的环境变量路径
• -e WEB_LOGIN：用于界面安装步骤中的数据库连接
• -e SRC_LOGIN：用于 Oragent 抓取过程中的数据库连接
• -v /u01：Oracle 数据库安装路径

⁠消费数据

消费 Oragent 的增量数据，可以使用以下客户端：

• Oragent Client for Java⁠

⁠获取授权

Oragent 以商业授权的方式，对外提供 Oracle 数据库增量抓取的能力。

⁠授权步骤

Oragent 的授权分为两步。

⁠第一步：联系九桥售前，获取授权文件

• 发送邮件⁠

• 企业微信

  

⁠第二步：将授权文件 sn.txt 拷贝进 Oragent 的容器

docker cp sn.txt <container_id>:/oragent

⁠加入社群

使用 Oragent 过程中遇到任何问题，进群解惑：