Amazon RDS for Oracle connection

To access your data in Amazon RDS for Oracle, create a connection asset for it.

Amazon RDS for Oracle is an Oracle relational database that runs on the Amazon Relational Database Service (RDS).

Supported Oracle versions and editions

  • Oracle Database 19c (19.0.0.0)
  • Oracle Database 12c Release 2 (12.2.0.1)
  • Oracle Database 12c Release 1 (12.1.0.2)

Create a connection to Amazon RDS for Oracle

To create the connection asset, you'll need these connection details:

  • Either the Oracle Service name or the Oracle System ID (SID) for the database.
  • Hostname or IP address of the database
  • Port number of the database. (Default is 1521)
  • SSL certificate (if required by the database server)

Select Server proxy to access the Amazon RDS for Oracle data source through a server proxy. Depending on its setup, a server proxy can provide load balancing, increased security, and privacy. The server proxy settings are independent of the authentication credentials and the personal or shared credentials selection. The server proxy settings cannot be stored in a vault.

  • Proxy hostname or IP address: The proxy URL. For example, https://proxy.example.com.
  • Server proxy port: The port number to connect to the proxy server. For example, 8080 or 8443.
  • The Proxy username and Proxy password fields are optional.

Choose the method for creating a connection based on where you are in the platform

In a project
Click Assets > New asset > Connect to a data source. See Adding a connection to a project.
In a catalog
Click Add to catalog > Connection. See Adding a connection asset to a catalog.
In a deployment space
Click Import assets > Data access > Connection. See Adding data assets to a deployment space.
In the Platform assets catalog
Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

Where you can use this connection

Projects

You can use Amazon RDS for Oracle connections in the following workspaces and tools:

Catalogs

  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

    Note:

    Preview, profile, and masking are not certified for this connection in IBM Knowledge Catalog.

Data lineage

  • Metadata import (lineage) (IBM Knowledge Catalog and IBM Manta Data Lineage)
Data Virtualization service
You can connect to this data source from Data Virtualization.

Amazon RDS for Oracle setup

To set up the Oracle database on Amazon, see these topics:

Configuring lineage metadata import for Amazon RDS for Oracle

When you create a metadata import for the Amazon RDS for Oracle connection, you can set options specific to this data source, and define the scope of data for which lineage is generated. For details about metadata import, see Designing metadata imports.

To import lineage metadata for Amazon RDS for Oracle, complete these steps:

  1. Create a data source definition. Select Oracle as the data source type. The Database (SID) or Service name field is required.
  2. Create a connection to the data source in a project.
  3. Create a metadata import. Learn more about options that are specific to Amazon RDS for Oracle data source:
    • When you define a scope, you can analyze the entire data source or use the include and exclude options to define the exact schemas that you want to be analyzed. See Include and exclude lists.
    • Optionally, you can provide external input in the form of a .zip file. You add this file in the Add inputs from file field. The file must have a supported structure. See External inputs.
    • Optionally, specify advanced import options.

Include and exclude lists

You can include or exclude assets up to the schema level. Provide databases and schemas in the format database/schema. Each part is evaluated as a regular expression. Assets which are added later in the data source will also be included or excluded if they match the conditions specified in the lists. Example values:

  • mySchema: mySchema schema
  • mySchema[1-5]: any schema with a name that starts with mySchema and ends with a digit between 1 and 5.

External inputs

If you use external Oracle PL/SQL scripts, you can add them in a .zip file as an external input. You can organize the structure of a .zip file as subfolders that represent schemas. After the scripts are scanned, they are added under respective schemas in the selected catalog or project. The .zip file can have the following structure:

<schema_name>
   <script_name.sql>
<script_name.sql>
replace.csv

The replace.csv file contains placeholder replacements for the scripts that are added in the .zip file. For more information about the format, see Placeholder replacements.

Advanced import options

Extract extended attributes
You can extract extended attributes like primary key, unique and referential integrity constraints of columns. By default these attributes are not extracted.
Extract invalid objects
Include invalid objects in extraction.
Extraction mode
You can decide which extraction mode to run for the imported metadata. You have the following options:
  • Prefetch: use it for relational databases.
  • Parallel bulk: use it for analytical processing engines.
  • Single-thread: use it to avoid parallelism and large queries during extraction. When you select this mode, performance might be low.
Transformation logic extraction
You can enable building transformation logic descriptions from SQL code in SQL scripts.
Dynamic SQL
Enable dynamic SQL processing in DDL scripts.

Learn more

Amazon RDS for Oracle

Parent topic: Supported connections