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. Optional: This connection supports Kerberos SSO with user impersonation, which requires additional configuration.
  • 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

Create a connection to Oracle based on your deployment:

Common connectivity

To create the connection, 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.

Select Server proxy to access the 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.

Credentials

  • If you select Shared, enter your username and password for the server.
  • If you select Personal, you have one of three choices:

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.

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