Before adding and running a Replicat for Amazon Kinesis, ensure
that you have the following:
An Amazon Kinesis connection created and assigned to your
target Big Data deployment
Your Amazon Web Services (AWS) region
Add a Replicat
(21c)
Learn to add a replicat process for Amazon Kinesis.
To add a Replicat for an Amazon Kinesis target:
In the OCI GoldenGate deployment console, on the Administration Service Overview page, click
Add Replicat (plus icon).
On the Add Replicat page, select a Replicat type, and then click
Next.
The types of Replicats are:
Classic Replicat
Coordinated Replicat
On the Replicat Options page, complete the following fields, and
then click Next:
For Process Name, enter a name for the Replicat
process.
(Optional) For Description, enter a brief description to
distinguish this Replicat from others.
For Trail Name, enter two-character trail name.
For Target, select Amazon Kinesis from the dropdown.
For Available Aliases for Amazon Kinesis, select
your alias from the dropdown.
On the Parameter File page, add and configure Replicat parameters as
needed, and then click Next.
If using Coordinated Replicat, add the following parameters on the
second line of the Parameter
File:
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
name>.properties
Using coordinated replicat will result in multiple files
created.
If omitted, you will encounter the following
error:
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
"/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
directory).
GoldenGate uses Greenwich Mean Time (GMT) by default. Use SETENV to
override the default setting for Replicats. This change doesn't apply to
deployments. For
example:
On the Properties File page, configure the following Amazon Kinesis
properties:
gg.eventhandler.kinesis.region:: provide
the AWS region for the target Amazon Kinesis stream.
gg.handler.kinesis.streamMappingTemplate=${tableName},
replace $(tableName} with the name of an existing data
stream, leave the default value as is, or use Template Keywords
to assign the stream name dynamically.
(Optional)
gg.handler.kinesis.partitionMappingTemplate=${primaryKeys},
leave the default value as is, or replace
${primaryKeys} with the template name to resolve
the message key.
Click Create and Run. If you click
Create, then you can manually start the Replicat later from the
Administration Service Overview page.
You return to the Administration Service Overview page where
you can view the creation of the Replicat process and access Replicat Actions.
In the OCI GoldenGate deployment console, on the Administration Service Home page, click
Add Replicat (plus icon).
In the Add Replicat panel, on the Replicat Information page,
complete the fields as needed, and then click Next:
Select a Replicat Type:
Classic Replicat
Coordinated Replicat
Enter a Process Name, no more than 5 characters
long.
Enter a Description, to help distinguish this
process from others.
On the Replicat Options page, complete the fields as needed, and
then click Next:
Replicat Trail:
Enter a Name.
Enter a Subdirectory, if you expect the Trail
file to be in a location other than the default.
Select an Encryption profile. If an
encryption profile wasn't created, the Local Wallet is selected by default.
For Begin, select the starting point for data
processing:
Position in Log (default)
Now
Custom Time
Trail Position:
Enter the Sequence Number.
Enter the RBA Offset.
Select your Target from the dropdown.
Note:
Depending on
your target selection, you may have additional options to such as Streaming,
Stage and Merge, and Staging locations.
Target Credentials:
Select a Domain.
Select an Alias within the specified
Domain.
Select a Checkpoint Table. Leave the default
selection or select the checkpoint table you created for the target
deployment.
Select the Max Threads Number (Coordinated
Replicats only).
On the Managed Options page, complete the optional fields as
needed, and then click Next:
Select a Profile Name, if one is available.
Enable Critical to deployment health.
Enable and configure Auto Start settings.
On the Parameter File page, you can add parameters to further
configure your Replicat. For example:
table source.table1;
If using Coordinated Replicat, add TARGETDB LIBFILE libggjava.so
SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties to
the parameters file.
Note:
GoldenGate uses Greenwich Mean Time (GMT) by default. Use SETENV to
override the default setting for this Replicat process. This change doesn't apply to
deployments. For example:
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
On the Properties File page, configure the following Amazon Kinesis properties:
gg.eventhandler.kinesis.region: provide
the AWS region for the target Amazon Kinesis stream.
gg.handler.kinesis.streamMappingTemplate=${tableName},
replace $(tableName} with the name of an existing data
stream, leave the default value as is, or use Template Keywords
to assign the stream name dynamically.
(Optional)
gg.handler.kinesis.partitionMappingTemplate=${primaryKeys},
leave the default value as is, or replace
${primaryKeys} with the template name to resolve
the message key.
Click Create and Run. If you click
Create, then you can manually start the Replicat later from the
Administration Service Home page.
Oracle customer access to and use of Oracle support
services will be pursuant to the terms and conditions specified in their Oracle
order for the applicable services.