6 Using Oracle GoldenGate for Real-time Data Distribution
6.3 Creating a Data Distribution Configuration
Refer to Figure 6–1 for a visual representation of the objects you will be creating.
Figure 6–1 Oracle GoldenGate Configuration Elements for Data Distribution
6.3.1 Source System
Configure the Manager process and primary Extract on the source system.
To configure the Manager process
1. On the source, configure the Manager process. See Chapter 3, "Configuring Manager and Network Communications" for instructions.
2. In the Manager parameter file, use the PURGEOLDEXTRACTS parameter to control the purging of files from the local trail.
To configure the primary Extract
1. On the source, use the ADD EXTRACT command to create an Extract group. For documentation purposes, this group is called ext.
ADD EXTRACT ext, {TRANLOG | INTEGRATED TRANLOG}, BEGIN time [option[, ...]]
See Reference for Oracle GoldenGate for Windows and UNIX for detailed information about these and other ADD EXTRACT options that may be required for your
installation.
2. On the source, use the ADD EXTTRAIL command to create a local trail.
ADD EXTTRAIL local_trail, EXTRACT ext
Use the EXTRACT argument to link this trail to the primary Extract group. The primary Extract group writes to this trail, and the data pump groups read it 3. On the source, use the EDIT PARAMS command to create a parameter file for the
primary Extract group. Include the following parameters plus any others that apply to your database environment. For possible additional required parameters, see the Oracle GoldenGate installation and setup guide for your database.
-- Identify the Extract group:
EXTRACT ext
-- Specify database login information as needed for the database:
[SOURCEDB dsn_1][, USERIDALIAS alias]
-- Log all scheduling columns if using integrated Replicat LOGALLSUPCOLS
-- Specify the local trail that this Extract writes to -- and encryption algorithm:
ENCRYPTTRAIL algorithm EXTTRAIL local_trail
-- Specify tables and sequences to be captured:
SEQUENCE [container.|catalog.]owner.sequence;
TABLE [container.|catalog.]owner.table;
Use EXTTRAIL to specify the local trail.
To configure the data pump Extract groups
1. On the source, use the ADD EXTRACT command to create a data pump for each target system. For documentation purposes, these groups are called pump_1 and pump_2.
ADD EXTRACT pump_1, EXTTRAILSOURCE local_trail, BEGIN time ADD EXTRACT pump_2, EXTTRAILSOURCE local_trail, BEGIN time
Use EXTTRAILSOURCE as the data source option, and supply the name of the local trail.
2. On the source, use the ADD RMTTRAIL command to specify a remote trail that will be created on each of the target systems.
ADD RMTTRAIL remote_trail_1, EXTRACT pump_1 ADD RMTTRAIL remote_trail_2, EXTRACT pump_2
Use the EXTRACT argument to link each remote trail to a different data pump group. The linked data pump writes to this trail.
See Reference for Oracle GoldenGate for Windows and UNIX for additional ADD RMTTRAIL options.
3. On the source, use the EDIT PARAMS command to create a parameter file for each of the data pumps. Include the following parameters plus any others that apply to your database environment.
Parameter file for pump_1:
-- Identify the data pump group:
EXTRACT pump_1
-- Specify database login information if using NOPASSTHRU:
[SOURCEDB dsn_1][, USERIDALIAS alias]
-- Decrypt the data only if the data pump must process it.
-- DECRYPTTRAIL
-- Specify the name or IP address of the first target system -- and optional encryption of data over TCP/IP:
RMTHOST target_1, MGRPORT port_number, ENCRYPT encryption_options -- Specify remote trail and encryption algorithm on first target system:
ENCRYPTTRAIL algorithm RMTTRAIL remote_trail_1
-- Allow mapping, filtering, conversion or pass data through as-is:
[PASSTHRU | NOPASSTHRU]
-- Specify tables and sequences to be captured:
SEQUENCE [container.|catalog.]owner.sequence;
TABLE [container.|catalog.]owner.table;
Parameter file for pump_2:
-- Identify the data pump group:
EXTRACT pump_2
-- Specify database login information if using NOPASSTHRU:
[SOURCEDB dsn_1][, USERIDALIAS alias]
-- Decrypt the data only if the data pump must process it.
-- DECRYPTTRAIL
-- Specify the name or IP address of the second target system -- and optional encryption of data over TCP/IP:
RMTHOST target_2, MGRPORT port_number, ENCRYPT encryption_options
-- Specify remote trail and encryption algorithm on second target system:
ENCRYPTTRAIL algorithm RMTTRAIL remote_trail_2
-- Allow mapping, filtering, conversion or pass data through as-is:
[PASSTHRU | NOPASSTHRU]
-- Specify tables and sequences to be captured:
SEQUENCE [container.|catalog.]owner.sequence;
TABLE [container.|catalog.]owner.table;
6.3.2 Target Systems
Configure the Manager process and Replicat groups on the target systems.
To configure the Manager process
1. On each target, configure the Manager process. See Chapter 3, "Configuring Manager and Network Communications" for instructions.
2. In each Manager parameter file, use the PURGEOLDEXTRACTS parameter to control the purging of files from the trail.
To configure the Replicat groups
1. On each target, create a Replicat checkpoint table (unless using Oracle integrated Replicat). See Section 14.3, "Creating a Checkpoint Table" for instructions.
2. On each target, use the ADD REPLICAT command to create a Replicat group for the remote trail on that system. For documentation purposes, these groups are called rep_1 and rep_2.
Command on target_1:
ADD REPLICAT rep_1
[, INTEGRATED | COORDINATED [MAXTHREADS number]]
, EXTTRAIL remote_trail_1, BEGIN time Command on target_2:
ADD REPLICAT rep_2
[, INTEGRATED | COORDINATED [MAXTHREADS number]]
, EXTTRAIL remote_trail_2, BEGIN time
Use the EXTTRAIL argument to link the Replicat group to the correct trail.
See Reference for Oracle GoldenGate for Windows and UNIX for detailed information about these and other options that may be required for your installation.
3. On each target, use the EDIT PARAMS command to create a parameter file for the Replicat group. Use the following parameters plus any others that apply to your database environment. For possible additional required parameters, see the Oracle GoldenGate installation and setup guide for your database.
Parameter file for rep_1:
-- Identify the Replicat group:
REPLICAT rep_1
-- State whether or not source and target definitions are identical:
SOURCEDEFS full_pathname | ASSUMETARGETDEFS
-- Specify database login information as needed for the database:
[TARGETDB dsn_2][, USERIDALIAS alias]
-- Specify error handling rules:
REPERROR (error, response)
-- Specify tables for delivery and threads if using coordinated Replicat:
MAP [container.|catalog.]owner.table, TARGET owner.table[, DEF template]
[, THREAD (thread_ID)]
[, THREADRANGE (thread_range[, column_list])]
;
Parameter file for rep_2:
-- Identify the Replicat group:
REPLICAT rep_2
-- State whether or not source and target definitions are identical:
SOURCEDEFS full_pathname | ASSUMETARGETDEFS
-- Specify database login information as needed for the database:
[TARGETDB dsn_3][, USERIDALIAS alias]
-- Specify error handling rules:
REPERROR (error, response)
-- Specify tables for delivery and threads if using coordinated Replicat:
MAP [container.|catalog.]owner.table, TARGET owner.table[, DEF template]
[, THREAD (thread_ID)]
[, THREADRANGE (thread_range[, column_list])]
;
You can use any number of MAP statements for any given Replicat group. All MAP statements for a given Replicat group must specify the same objects that are contained in the trail that is linked to the group.
7
7