Add a Replicat for Amazon Kinesis

Learn to create a Replicat process for an Amazon Kinesis target in OCI GoldenGate.

Before you begin

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 for Amazon Kinesis

Learn to add a replicat process for Amazon Kinesis.

To add a Replicat for an Amazon Kinesis target:
  1. In the OCI GoldenGate deployment console, on the Administration Service Overview page, click Add Replicat (plus icon).
  2. On the Add Replicat page, select a Replicat type, and then click Next.
    The types of Replicats are:
    • Classic Replicat
    • Coordinated Replicat
  3. On the Replicat Options page, complete the following fields, and then click Next:
    1. For Process Name, enter a name for the Replicat process.
    2. (Optional) For Description, enter a brief description to distinguish this Replicat from others.
    3. For Trail Name, enter two-character trail name.
    4. For Target, select Amazon Kinesis from the dropdown.
    5. For Available Aliases for Amazon Kinesis, select your alias from the dropdown.
  4. On the Parameter File page, add and configure Replicat parameters as needed, and then click Next.

    Note:

    • 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 example:
      setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

      Learn more about SETENV.

  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.
  6. 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.