【跟我学ogg12.3.0.1】第二节【Oracle GoldenGate之Oracle篇】6 以集成模式配置捕获

6 Configuring Capture in Integrated Mode

本章包含配置Oracle GoldenGate捕获过程以以集成模式捕获事务数据的说明。

Note:

To switch an active Extract configuration from classic to integrated mode, perform these configuration steps and then see Administering Oracle GoldenGate.

Topics:

• 配置集成捕获的先决条件
  在以集成模式配置摘要之前，必须遵循本主题中提供的指导原则。
  从这些指示中可以期望得到什么
  这些指令向您展示如何配置一个基本提取参数(配置)文件的主要提取物、捕捉交易数据从数据源,为data-pump提取,传播了本地存储的数据在一个小道从源系统到目标系统。
• 以集成捕获模式配置主提取
  主提取从logmining服务器捕获日志更改记录的挖掘数据库可以是本地的，也可以是源数据库的下游。
  配置数据泵提取
  数据泵可以执行数据过滤、映射和转换，也可以配置为直通模式，在这种模式下，数据按原样被动传输，无需操作。
• 下一个步骤
  参数文件是由关联的Oracle GoldenGate进程读取的纯文本文件。Oracle GoldenGate使用两种类型的参数文件:全局参数文件和运行时参数文件。

6.1 配置集成捕获的先决条件

在以集成模式配置摘要之前，必须遵循本主题中提供的指导原则。

在综合模式下配置摘录的指引如下:

1. 为Oracle GoldenGate准备数据库。
   建立Oracle GoldenGate证书。
   选择捕获和应用模式。

2. 通过配置管理器进程在源系统上创建Oracle GoldenGate实例。参见管理Oracle GoldenGate。
   另外，请参阅管理Oracle GoldenGate的指南

Parent topic: Configuring Capture in Integrated Mode

6.2 What to Expect from these Instructions

这些指令向您展示如何配置一个基本提取参数(配置)文件的主要提取物、捕捉交易数据从数据源,为data-pump提取,传播了本地存储的数据在一个小道从源系统到目标系统。

您的业务需求可能需要更复杂的拓扑结构，但是此过程构成了其余配置步骤的基础。

通过执行这些步骤，您可以:

• 建立基本的配置文件。
  稍后，在您决定应用于您的环境的特性或需求时，通过添加更多的参数来构建它们。
  使用它们的副本可以比从零开始更快地创建其他参数文件。

Parent topic: Configuring Capture in Integrated Mode

6.3 以集成捕获模式配置主提取

主提取从logmining服务器捕获日志更改记录的挖掘数据库可以是本地的，也可以是源数据库的下游。

这些步骤将主提取配置为从任意位置以集成模式捕获事务数据。有关从下游挖掘数据库捕获的更多信息，请参见配置下游挖掘数据库和示例下游挖掘配置。

Note:

一个提取组通常足以从一个多租户容器数据库中的单个数据库或多个可插拔数据库中捕获。请参阅在多租户容器数据库中配置Oracle GoldenGate。

1. In GGSCI on the source system, create the Extract parameter file.

   EDIT PARAMS name
   

   Where: name is the name of the primary Extract.

2. 按照显示的顺序输入提取参数，为每个参数语句开始一个新行。本文给出了常规数据库和多租户容器数据库的示例。两者之间的区别是在表和序列规范中必须使用两部分对象名还是三部分对象名。有关更多信息和参数描述，请参见主提取(经典模式或集成模式)的基本参数。

   提取的基本参数，其中挖掘数据库是下游数据库，是常规数据库。是一个常规的数据库与源ADG用于获取

   EXTRACT financep
   USERIDALIAS tiger1
   LOGALLSUPCOLS
   UPDATERECORDFORMAT COMPACT
   DDL INCLUDE MAPPED
   ENCRYPTTRAIL AES192
   EXTTRAIL /ggs/dirdat/lt
   SEQUENCE hr.employees_seq;
   TABLE hr.*;
   

   提取的基本参数挖掘数据库是一个下游数据库，是一个多租户容器数据库，源ADG用于提取

   EXTRACT financep
   USERIDALIAS tiger1
   LOGALLSUPCOLS
   UPDATERECORDFORMAT COMPACT
   DDL INCLUDE MAPPED SOURCECATALOG pdb1 INCLUDE MAPPED SOURCECATALOG pdb2
   ENCRYPTTRAIL AES192
   EXTTRAIL /ggs/dirdat/lt
   TABLE test.ogg.tab1;
   SOURCECATALOG pdb1
   SEQUENCE hr.employees_seq;
   TABLE hr.*;
   SOURCECATALOG pdb2
   TABLE sales.*;
   TABLE acct.*;
   

   用于提取的基本参数，其中挖掘数据库是下游数据库，是常规数据库

   EXTRACT financep
   USERIDALIAS tiger1 
   TRANLOGOPTIONS MININGUSERALIAS tiger2 
   TRANLOGOPTIONS INTEGRATEDPARAMS (MAX_SGA_SIZE 164, & 
      DOWNSTREAM_REAL_TIME_MINE y)
   LOGALLSUPCOLS
   UPDATERECORDFORMAT COMPACT
   DDL INCLUDE MAPPED
   ENCRYPTTRAIL AES192
   EXTTRAIL /ggs/dirdat/lt
   SEQUENCE hr.employees_seq;
   TABLE hr.*;
   

   主提取的基本参数，其中挖掘数据库是下游数据库，是多租户容器数据库

   EXTRACT financep
   USERIDALIAS tiger1 
   TRANLOGOPTIONS MININGUSERALIAS tiger2 
   TRANLOGOPTIONS INTEGRATEDPARAMS (MAX_SGA_SIZE 164, & 
      DOWNSTREAM_REAL_TIME_MINE y)
   LOGALLSUPCOLS
   UPDATERECORDFORMAT COMPACT
   DDL INCLUDE MAPPED SOURCECATALOG pdb1 INCLUDE MAPPED SOURCECATALOG pdb2
   ENCRYPTTRAIL AES192EXTTRAIL /ggs/dirdat/lt
   TABLE test.ogg.tab1;
   SOURCECATALOG pdb1
   SEQUENCE hr.employees_seq;
   TABLE hr.*;
   SOURCECATALOG pdb2
   TABLE sales.*;
   TABLE acct.*;
   

   Parameter	Description
   EXTRACT group	组是提取组的名称。有关更多信息, see Reference for Oracle GoldenGate.
   USERIDALIAS alias	指定要提取的用户的数据库登录凭据的别名。此凭据必须存在于Oracle GoldenGate凭据存储中。
   LOGALLSUPCOLS	将所有补充记录的列写入trail，包括冲突检测和解决所需的列，以及支持集成副本所需的调度列。(调度列是主键、惟一索引和外键列。)将数据库配置为使用GGSCI命令记录这些列。 See Establishing Oracle GoldenGate Credentials.
   UPDATERECORDFORMAT COMPACT	将更新操作的前后图像合并到跟踪中的单个记录中。此参数对Oracle数据库版本12c及更高版本有效，以支持集成模式下的Replicat。虽然不是必需的参数，但UPDATERECORDFORMAT COMPACT是一种最佳实践，可以显著提高副本的性能。See Reference for Oracle GoldenGate for more information.
   TRANLOGOPTIONS MININGUSERALIAS alias	指定下游挖掘数据库中的日志挖掘服务器的连接信息(如果正在使用)。 MININGUSERALIAS指定下游挖掘数据库的提取用户的别名。This is the user that you created in Configuring a Downstream Mining Database. The credential for this user must be stored in the Oracle GoldenGate credential store. See Administering Oracle GoldenGate for more information. 仅当数据库日志挖掘服务器位于与源数据库不同的数据库中时才使用MININGUSERALIAS;否则就使用USERIDALIAS。在使用MININGUSERALIAS时，除了USERIDALIAS之外还要使用它，因为这两个数据库都需要凭据。
   TRANLOGOPTIONS [INTEGRATEDPARAMS (parameter[, ...])]	可选，将参数传递给包含数据库日志挖掘服务器的Oracle数据库。仅用于更改日志挖掘服务器参数的默认设置。 See Additional Parameter Options for Integrated Capture.
   TRANLOGOPTIONS CHECKPOINTRETENTIONTIMEdays	可选，控制提取保留检查点的天数，然后自动清除它们。部分天数可以使用十进制值指定。例如，8.25指定8天6小时. For more information, see Reference for Oracle GoldenGate.
   DDL include_clause	如果复制DDL操作，则需要. See Configuring DDL Support for more information.
   ENCRYPTTRAIL algorithm	加密本地路径。有关Oracle GoldenGate trail加密选项的更多信息, see Administering Oracle GoldenGate.
   EXTTRAIL pathname	指定主提取写入捕获数据的本地跟踪的路径名. For more information, see Reference for Oracle GoldenGate
   SOURCECATALOG container	当源数据库是多租户容器数据库时使用此参数。指定可插入数据库的名称，该数据库将用作包含两部分名称的所有后续表和序列参数的默认容器。此参数使您能够使用由两部分组成的对象名称(schema.object)，而不是由三部分组成的名称(container.schema.object)。在遇到另一个SOURCECATALOG参数或遇到完整的由三部分组成的表或序列规范之前，它仍然有效。
   {TABLE | SEQUENCE} [container.]schema.object;	指定要为其捕获数据的数据库对象。 TABLE specifies a table or a wildcarded set of tables. SEQUENCE specifies a sequence or a wildcarded set of sequences. container is the name of the pluggable database (PDB) that contains the object, if this database is a multitenant container database. The container part of the name is not required if this Extract group will only process data from one PDB and the default PDB is specified with the SOURCECATALOG parameter. schema is the schema name or a wildcarded set of schemas. object is the table or sequence name, or a wildcarded set of those objects. See Administering Oracle GoldenGate for information about how to specify object names with and without wildcards. 用分号结束参数语句。 要从通配符规范中排除一个名称，可以适当地使用CATALOGEXCLUDE、SCHEMAEXCLUDE、TABLEEXCLUDE和EXCLUDEWILDCARDOBJECTSONLYparameters。 有关更多信息和控制数据筛选、映射和操作的附加表选项, see Reference for Oracle GoldenGate.
   MAPINVISIBLECOLUMNS	控制Replicat是否在Oracle目标表中包含用于默认列映射的不可见列。使用SQL配置列映射中的不可见列，以显式指定列名。例如: CREATE TABLE tab1 (id NUMBER, data CLOB INVISIBLE); INSERT INTO tab1 VALUES (1, 'a');ERROR: ORA-913 INSERT INTO tab1 (id, data) VALUES (1, 'a'); OK 可以使用ALTER TABLE更改列的可见性。不可见列可以是索引的一部分，包括主键和惟一索引。

3. 输入为您的配置推荐的任何可选提取参数。可以使用GGSCI中的edit PARAMS命令在开始处理之前的任何时间编辑这个文件。 For more information, see the Reference for Oracle GoldenGate.
4. Save and close the file.

Parent topic: Configuring Capture in Integrated Mode

6.4 Configuring the Data Pump Extract

数据泵可以执行数据过滤、映射和转换，也可以配置为直通模式，在这种模式下，数据按原样被动传输，无需操作。

这些步骤配置数据泵，它读取本地跟踪并将数据通过网络发送到远程跟踪。数据泵是可选的，但推荐使用。

1. In GGSCI on the source system, create the data-pump parameter file.

   EDIT PARAMS name
   

   Where: name is the name of the data pump Extract.

2. 按照显示的顺序输入数据泵参数，为每个参数语句开始一个新行。你的输入变量将会不同。
   使用两部分对象名称的数据泵提取组的基本参数:

   EXTRACT extpump
   USERIDALIAS tiger1
   RMTHOST fin1, MGRPORT 7809 ENCRYPT AES192, KEYNAME securekey2
   RMTTRAIL /ggs/dirdat/rt
   SEQUENCE hr.employees_seq;
   TABLE hr.*;
   

   Basic parameters for the data-pump Extract group using three-part object names (including a pluggable database):

   EXTRACT extpump
   USERIDALIAS tiger1
   RMTHOST fin1, MGRPORT 7809 ENCRYPT AES192, KEYNAME securekey2
   RMTTRAIL /ggs/dirdat/rt
   TABLE test.ogg.tab1;
   SOURCECATALOG pdb1
   SEQUENCE hr.employees_seq;
   TABLE hr.*;
   SOURCECATALOG pdb2
   TABLE sales.*;
   TABLE acct.*;
   

   Parameter	Description
   EXTRACT group	group is the name of the data pump Extract. For more information, see Reference for Oracle GoldenGate.
   USERIDALIAS alias	Specifies the alias of the database login credential of the user that is assigned to Extract. This credential must exist in the Oracle GoldenGate credential store.
   RMTHOST hostname, MGRPORT portnumber, [, ENCRYPT algorithm KEYNAME keyname]	RMTHOST specifies the name or IP address of the target system. MGRPORT specifies the port number where Manager is running on the target. ENCRYPT specifies optional encryption of data across TCP/IP. For additional options and encryption details, see Reference for Oracle GoldenGate.
   RMTTRAIL pathname	Specifies the path name of the remote trail. For more information, see Reference for Oracle GoldenGate.
   SOURCECATALOGcontainer	Use this parameter when the source database is a multitenant container database. Specifies the name of a pluggable database that is to be used as the default container for all subsequent TABLE and SEQUENCE parameters that contain two-part names. This parameter enables you to use two-part object names (schema.object) rather than three-part names (container.schema.object). It remains in effect until another SOURCECATALOG parameter is encountered or a full three-part TABLE or SEQUENCE specification is encountered. Use this parameter when the source database is a multitenant container database. See Reference for Oracle GoldenGatefor more information about SOURCECATALOG.
   {TABLE | SEQUENCE} [container.]schema.object;	Specifies a table or sequence, or multiple objects specified with a wildcard. In most cases, this listing will be the same as that in the primary Extract parameter file. TABLE specifies a table or a wildcarded set of tables. SEQUENCE specifies a sequence or a wildcarded set of sequences. container is the name of the root container or pluggable database that contains the table or sequence, if this source database is a multitenant container database. See the SOURCECATALOG description in this table. schema is the schema name or a wildcarded set of schemas. object is the name of a table or sequence, or a wildcarded set of those objects. See Administering Oracle GoldenGate for information about how to specify object names with and without wildcards. Terminate this parameter statement with a semi-colon. To exclude tables or sequences from a wildcard specification, use the TABLEEXCLUDEor SEQUENCEEXCLUDE parameter after the TABLE statement. For more information and for additional TABLE options that control data filtering, mapping, and manipulation, see Reference for Oracle GoldenGate.

3. Enter any optional Extract parameters that are recommended for your configuration. You can edit this file at any point before starting processing by using the EDIT PARAMS command in GGSCI.
4. Save and close the file.

Parent topic: Configuring Capture in Integrated Mode

6.5 Next Steps

参数文件是由关联的Oracle GoldenGate进程读取的纯文本文件。Oracle GoldenGate使用两种类型的参数文件:全局参数文件和运行时参数文件。

创建了用于classic capture的基本参数文件后，请参阅下面的相关配置步骤。

Configuring Oracle GoldenGate Apply

Configuring Oracle GoldenGate in a Multitenant Container Database

Additional Oracle GoldenGate Configuration Considerations

Configuring DDL Support (to use Oracle GoldenGate DDL support)

Creating Process Groups (to use Oracle GoldenGate DDL support)

Instantiating Oracle GoldenGate Replication

Optional Parameters for Integrated Modes

Configuring a Downstream Mining Database

Example Downstream Mining Configuration

Supporting Changes to XML Schemas

Parent topic: Configuring Capture in Integrated Mode