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:

  • Select a Connection mode to connect to Oracle:

    • SID: Provide the unique name of the database.
    • Service name: Provide the name of the service.

  • 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 a Failover mode for alternate servers:

    • Connect
    • Extended
    • Select

  • Load balancing: Enable this option if you want to use client load balancing.

  • Use DBA catalog views: Enable this option to use custom DBA catalog views to discover and import metadata from the database.

  • Include public synonyms: Enable this option to include public synonyms during table discovery.

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

Common connectivity

  • Username and password

  • Impersonate User and Impersonate User password: The Oracle username and password to be impersonated during the connection.

  • Choose the required Number type for number values in the data source:

    • Double
    • Varchar

  • Port is SSL-enabled: Enable this option if the port you have chosen is configured to accept SSL connections.

    If the Port is SSL-enabled option is enabled, fill in the following fields:

    • SSL certificate: Enter the SSL certificate of the host to be trusted
    • Hostname in SSL certificate: The hostname in SubjectAlternativeName or Common Name (CN) part of the SSL certificate
    • Validate the SSL certificate: Enable this option to validate that the SSL certificate returned by the host is trusted.

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

This 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