Connect to Oracle Database

Learn how to create a connection to an Oracle Database to use as a source or target.

Before you begin

Ensure that you:

Create the connection

To create an Oracle Database connection:
  1. From the OCI GoldenGate Overview page, click Connections.
    You can also click Create Connection under the Get started section and skip to step 3.
  2. On the Connections page, click Create Connection.
  3. In the Create Connection panel, complete the General Information fields as follows:
    1. For Name, enter a name for the connection.
    2. (Optional) For Description, enter a description that helps you distinguish this connection from others.
    3. For Compartment, select the compartment in which to create the connection.
    4. From the Type dropdown, under Oracle, select Oracle Database.
    5. (Optional) Click Show advanced options to manage keys or add tags.
      1. Under Security, select one of the following:
        • Select Use Oracle-managed encryption key to leave all encryption key management to Oracle.
        • Select Use customer-managed encryption key to select a specific encryption key stored in your OCI Vault to encrypt your connection credentials.
      2. Under Tags, add tags to organize your resources.
  4. Click Next.
  5. Complete the Connection Details fields as follows:
    1. Choose Select database to select an existing database in the selected compartment, and then complete the rest of the fields as needed. Click Change Compartment to select a database in a different compartment. Complete the following fields:
    2. Choose Enter database information to enter the database details manually:
      1. (Optional) For Database connection string, enter the database's connection string.

        Note:

        • To find the connection string, click DB Connection on the database's Details page.
        • If you enter a private IP, then OCI GoldenGate rewrites the private IP in the format, ip-10-0-0-0.ociggsvc.oracle.vcn.com.
      2. For Database username, enter the username to connect to the database with.
      3. For Database password, enter the password associated to the username provided in the previous step.

        Note:

        If using Oracle Database, ensure that you use the CDB user to capture data from PDBs. See Configuring Oracle GoldenGate in a Multitenant Container Database.
      4. (Optional) For Database wallet, drag and drop or select the wallet.zip for this database.

        Note:

        The wallet.zip must contain the cwallet.sso and tnsnames.ora files. Within the tnsnames.ora, one of the entries must have the suffix, _low, and description, security, and connect_data parameter value pairs in all lowercase letters. For example:
        wdb19c_low =
    (description=(address=(protocol=tcps)(host=<hostname>)(port=<port_number>))(connect_data=(server=dedicated)(service_name=<service_name>))(security=(ssl_server_dn_match=true)(ssl_server_cert_dn="cn=<cert_name>")))
    3. For Network connectivity, select a Traffic routing method:
      • Shared endpoint, to share an endpoint with the assigned deployment. You must allow connectivity from the deployment's ingress IP.
      • Dedicated endpoint, for network traffic through a dedicated endpoint in the assigned subnet in your VCN. You must allow connectivity from this connection's ingress IPs.

        Note:

        Select this option for on premise Oracle Databases not available over the public internet.

        Then, select a Session mode:

        • Direct, to use the local listener running on a single database node, and then select your subnet.
        • Redirect, to use the SCAN listener used in Oracle Real Application Cluster (RAC) deployments, and then select your subnet.

          Tip:

          Subnet is only required when you enter the database details manually, and the database is public. Private databases already have their own subnet.

        Note:

        Learn more about Oracle GoldenGate connectivity.
  6. Click Create.
After the connection is created, it appears in the Connections list. Ensure that you assign the connection to a deployment to use it as a source or target in a replication.

Related Topics

Known issues

Network timeout affects database connections using private endpoints.

If you're using a private enpoint to connect to a database, then you may encounter network timeouts when starting or stopping Extract processes.

Workaround: You can do one of the following:

  • Apply the latest patches from your deployment details page. In the Deployment Information section, under GoldenGate, for Version, click Upgrade.
  • If you're unable to apply the latest patches at this time, you can update the connection string to include EXPIRE_TIME=1. By default, you may have an EZ connection string in Oracle GoldenGate. This connection string needs to be updated in the Oracle GoldenGate Credential to a long connection string as follows:
    <username>@//<hostname>:1521/<service_name>
<username> @(DESCRIPTION = (EXPIRE_TIME=1)(ADDRESS_LIST = (ADDRESS = (COMMUNITY = tcp)(PROTOCOL = TCP)(Host = <hostname>)(Port = 1521))) (CONNECT_DATA = (SERVICE_NAME = <service_name>)))

SCAN Proxy doesn't support TLS

While OCI GoldenGate supports Oracle Single Client Access Name (SCAN) hosts and IPs, the SCAN proxy does not support TLS.

Workaround: You can connect to a RAC database using the Database Node IP.