Oracle connection

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

Oracle is a multi-model database management system.

Supported versions

Oracle Database 19c and 21c

Prerequisites for Kerberos SSO authentication

If you plan to use Kerberos SSO authentication, complete these requirements:

Configure the data source for Kerberos authentication.
Confirm that the service that you plan to use the connection supports Kerberos. For more information, see Kerberos authentication in Cloud Pak for Data.
An administrator must complete the steps for Configuration for Kerberos SSO.

Create a connection to Oracle

To create the connection asset, you need the following connection details:

Service name or Database (SID)
Hostname or IP address
Port number
SSL certificate (if required by the database server)
Alternate servers: A list of alternate database servers to use for failover for new or lost connections.
Syntax: (servername1[:port1][;property=value[;...]][,servername2[:port2][;property=value[;...]]]...)

The server name (servername1, servername2, and so on) is required for each alternate server entry. The port number (port1, port2, and so on) and the connection properties (property=value) are optional for each alternate server entry. If the port is unspecified, the port number of the primary server is used.

If the port number of the primary server is not specified, the default port number 1521 is used.

The optional connection properties are the ServiceName and SID.
Metadata discovery: The setting determines whether comments on columns (remarks) and aliases for schema objects such as tables or views (synonyms) are retrieved when assets are added by using this connection.

Credentials

If you select Shared, enter your username and password for the server.
If you select Personal, you have one of three choices:
- Enter your username and password for the server manually.
- Use secrets from a vault.
- Select Kerberos SSO. To use Kerberos SSO, you must complete the Prerequisites for Kerberos SSO authentication.

For Credentials and Certificates, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

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 deployment space: Click Add to space > Connection. See Adding connections to a deployment space.
In the Platform assets catalog: Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

See Add data from a connection in a project.

Where you can use this connection

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

Projects

AutoAI (Watson Machine Learning)
Data Refinery (Watson Studio)
Decision Optimization (Watson Studio and Watson Machine Learning)
Notebooks (Watson Studio). Click Read data on the Code snippets pane to get the connection credentials and load the data into a data structure. For more information, see Load data from data source connections.
SPSS Modeler (SPSS Modeler service)
Synthetic Data Generator (Synthetic Data Generator service)

Catalogs

Platform assets catalog

Federal Information Processing Standards (FIPS) compliance

The Oracle connection cannot be created in a FIPS environment.

Oracle setup

Oracle installation

Running SQL statements

To ensure that your SQL statements run correctly, refer to the Oracle Supported SQL Syntax and Functions for the correct syntax.

Learn more

Oracle product documentation

Parent topic: Supported connections