Extract is a process that runs agains the source data
source connection and extracts, or captures, data. Learn to add an Extract for MySQL Database Server, HeatWave on OCI, Azure Database for MySQL, HeatWave on AWS,
Amazon Aurora MySQL, Amazon RDS for MySQL, Amazon RDS for MariaDB, Google Cloud SQL for MySQL, SingleStoreDB, SingleStoreDB Cloud, HeatWave on AWS, and HeatWave on Azure technologies.
To add an extract for MySQL database in Oracle GoldenGate 21c:
In the OCI GoldenGate deployment console, ensure that you're on the Administration Service
Overview page, and then click Add Extract (plus icon).
On the Add Extract page, for Extract Type,
select one of the following, and then click Next.
Change Data Capture
Initial Load
On the Extract Options page, under Basic Information, complete the
fields as needed:
For Process Name, enter a name for the Extract process, up to 8
characters.
(Optional) For Description, enter a brief description to help you
distinguish this process from others.
For Intent, select the option that best describes the
purpose of this Extract:
Unidirectional (default)
Disaster Recovery
N-Way
Enable Remote only if capturing data from a MySQL database that doesn't use
global transaction identifiers (GTIDs).
For Credential Domain, select Oracle GoldenGate.
For Credential Alias, select your source MySQL connection.
For Trail Name, enter a two character name for the Trail file.
(Optional) For Trail Subdirectory, set a custom location for the generated
Trail file.
(Optional) For Trail Size, set the max size for the generated trail
file.
(Optional) Under Encryption Profile, enter the encryption profile description. The
Local Wallet profile is selected by default if an encryption profile wasn't created.
Select the profile name from the dropdown. You can select the Local Wallet or a
custom profile.
Select the encryption profile from the dropdown.
Specify the masterkey for the encryption profile.
(Optional) Under Managed Options, you can configure the
following:
Profile Name
Auto Start
Auto Restart
Note
Adding a profile and configuring Auto Start and Auto Restart
options enables your deployment to restart automatically after a network disruption. See
Configure managed processes for more
information.
Click Next.
On the Extract Parameters page, you can edit the parameter file in the text area to
list the table details to capture. For example:
table source.table1;
Note
GoldenGate uses Greenwich Mean Time
(GMT) by default. Use SETENV to override the default setting for the Extract. This
change applies only to the Extract process and not the
deployment.
Select Register Extract in the background to register the
Extract in the background asynchronously.
Click Create and Run to create and start the Extract. If you
click Create, then you can manually start Extract later from the
Administration Service Overview page.
You're returned to the Administration Service Overview
page, where you can view the status of the Extract process. Select
Details from the Extract Action menu to view
process information, checkpoint, statistics, paramters, and reports.
Learn more 🔗
Interested in learning more about the Extract process and capturing data? See:
Remote
change data capture Extracts fail for GTID
enabled databases
When you create a Change Data Capture
Extract process with the Remote option enabled for a
MySQL database that uses global transaction identifiers (GTIDs), the
Extract process fails and the
following error is
reported:
ERROR OGG-25192 Trail file '<trail name>' is remote. Only local trail allowed for this extract.
Workaround: On the Parameter file screen
of the Change Data Capture Extract, remove
the line, TRANLOGOPTIONS ALTLOGDEST REMOTE.