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

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

  • Username and password

  • 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.

StreamSets

To create a connection to use in StreamSets flows, you need the following 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

In StreamSets flows, the Oracle connection supports only the Oracle JDBC Thin driver. To use a different driver, specify connection properties in the Oracle stage in the StreamSets flow.

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.

StreamSets

  • Username and password

For Private connectivity, to connect to a database that is not externalized to the internet (for example, behind a firewall), you must set up a secure connection.

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