Prerequisites for Creating a Connection

Satisfy the following prerequisites specific to your environment to create a connection with the Oracle Autonomous Data Warehouse Adapter.

Download the Client Credentials Wallet

Download the client credentials wallet from the Oracle Autonomous Data Warehouse instance. See Download Client Credentials (Wallets) in Using Oracle Autonomous Database Serverless.

Know Database Instance Details

  1. Ensure that the target database is accessible.
  2. Ensure that you have write permissions to the database.
  3. Ensure that you have the required permissions to run stored procedures and SQL statements.
  4. Know the database service name.
  5. Know the database service username and password for connecting to the database.

Complete Bulk Data Import Operation Prerequisites

If you want to use the bulk data import operation, you must configure the Oracle Autonomous Data Warehouse Adapter to use the JDBC With OCI Signature security policy on the Connections page. Before you can successfully configure this security policy on the Connections page, you must complete the following prerequisites.

  • Create an object storage bucket in Oracle Cloud Infrastructure and obtain the OCID value of the compartment in which you create the storage bucket. You need this value when configuring the security policy on the Connections page.
    You specify the OCID of the object storage user on the Connections page when configuring the JDBC With OCI Signature security policy. This user should have the manage bucket and manage object privileges. Set the following policies to manage privileges on the bucket and object in the object storage:
    Allow group group_name to manage buckets in compartment compartment_name
    
    Allow group group_name to manage objects in compartment compartment_name 
    

    See How Policies Work and Policy Reference.

  • Obtain the tenancy OCID and user OCID details in the Oracle Cloud Infrastructure Console. You need these values when configuring the security policy on the Connections page. When you sign up for Oracle Cloud Infrastructure, Oracle creates a tenancy for your company, which is a secure and isolated partition within Oracle Cloud Infrastructure where you can create, organize, and administer your cloud resources.
    1. Sign in to the Oracle Cloud Infrastructure Console.
    2. Open the navigation menu and click Governance & Administration. Under Account Management, click Tenancy Details.
    3. In the Tenancy Information section, click Show to display the OCID tenancy value.
    4. Copy the value. You need this value when configuring the security policy on the Connections page.
    5. Click the Profile icon and select User Settings.

      Note:

      You can also open the navigation menu and click Identity & Security. Under Identity, click Users to access the user profile.
    6. Click Show to display the OCID user value.
    7. Copy the value.
  • Create an API signing key. You then specify the signing key in Oracle Cloud Infrastructure.
    1. Sign in to the Oracle Cloud Infrastructure Console.
    2. Open the navigation menu and click Identity & Security. Under Identity, click Users.
    3. On the Users page, click the link of the user name to use.
    4. Under Resources, click API Keys, then click Add API Key.

      Note:

      Only a private key without a pass phrase/password is supported.
    5. In the Add API Key dialog, select Paste Public Key and enter the contents of the public key you created, then click Add.
    6. Copy the finger print value generated by Oracle Cloud Infrastructure. You need this value when configuring the JDBC With OCI Signature security policy on the Connections page.

      API Keys section with an Add Public Key link and fingerprint value.