Connect to Oracle AI Data Platform

Learn to create a Oracle AI Data Platform connection.

Before you begin

Ensure that you:

Review how how OCI GoldenGate connects to your sources and targets.
Create a dynamic group for your deployment. You can choose to authorize a single deployment or all deployment in a compartment or tenancy. See Writing matching rules to define dynamic groups. For example:
```
ALL {resource.type = 'goldengatedeployment', resource.compartment.id = 'compartment_ocid'}
```

Add the required policies for the dynamic group. For example:

allow dynamic-group <your_dynamic_group> to manage object-family in tenancy

Have an Oracle Object Storage bucket created.
Create an API key.

Create the connection

To create an Oracle AI Data Platform connection:

From the OCI GoldenGate Overview page, select Connections.

You can also select Create Connection under the Get started section and skip to step 3.
On the Connections page, select Create Connection.
On the Create Connection page, complete the 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 GoldenGate on Multicloud only) Select your Subscription, and then complete the following fields.
  1. From the Compartment dropdown, select the compartment in which the Resource Anchor resides.
  2. Select the Multicloud partner region.
  3. Select your Partner availability zone. The available options populate based on the selected Multicloud partner region.
4. For Compartment, select the compartment in which to create the connection.
5. For Type, select Oracle AI Data Platform.
6. For Connection URL, enter the Oracle AI Data Platform JDBC URL.
  
  Note: To find the JDBC URL, in the Oracle AI Data Platform console, select Compute, your instance, and then Connection Details. Copy the JDBC URL.
7. For User, select from the following options:
  - Use current tenancy and user, and then enter the following information:
    1. Select the Private key file secret. If located in a different compartment, use the dropdown to change compartments.
    2. (Optional) Select the Private key passphrase secret. If located in a different compartment, use the dropdown to change compartments.
    3. For Public key fingerprint, enter the API key created for the user.
  - Use resource principal to authenticate and access other OCI resources.
  - Specify another tenancy and user, and then enter the following information:
    1. Enter the Tenancy OCID.
    2. Enter the User OCID.
    3. Select the Private key file secret. If located in a different compartment, use the dropdown to change compartments.
    4. Select the Private key passphrase secret. If located in a different compartment, use the dropdown to change compartments.
    5. For Public key fingerprint, enter the API key created for the user.
8. For Region, select the region in which your Oracle AI Data Platform instance is located.
9. Expand Show advanced options. You can configure the following options:
  - Security
    - Deselect Use vault secrets you prefer not to use password secrets for this connection. If not selected:
      - 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.
  - Network connectivity
    - 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:
      
      If a dedicated connection remains unassigned for seven days, then the service converts it to a shared connection.
      
      Learn more about Oracle GoldenGate connectivity.
  - Security attributes: Add security attributes to control access to this connection using Zero Trust Packet Routing (ZPR).
  - Tags: Add tags to organize your resources.
Select Create.

After the service creates the connection, it appears in the Connections list. Ensure that you assign the connection to a deployment to use it in a data replication.

Next steps

Known issues

Oracle AI Data Platform: Resource Principal authentication

Resource Principal authentication for Oracle AI Data Platform connections encounter the following error:

JDBCMDP-00034 Current attempt to connect failed with error: [[JDBC Driver]Could not find private key: /tmp/ogg/ocid1.goldengateconnection.oc1.phx.amaa...lqabqqxq/privateKeyFile].

Workaround: Edit the connection and select a different authentication method such as Use current tenancy and user or Specify another tenancy and user.