Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r0821


D toc

You can create connections to one or more Oracle databases from

D s product
rtrue

Pre-requisites

Info

NOTE: Dots (.) in the names of Oracle tables or table columns are not supported.

  • If you haven't done so already, you must create and deploy an encryption key file for the 
    D s node
     to be shared by all relational connections. For more information, see Create Encryption Key File

SSL

If you are connecting to the Oracle database using SSL, additional configuration is required in Oracle.

D s product
supports the use of the following SSL ciphers to communicate with Oracle:

Code Block
SSL_RSA_WITH_3DES_EDE_CBC_SHA
SSL_RSA_WITH_RC4_128_SHA
SSL_RSA_WITH_RC4_128_MD5
SSL_RSA_WITH_DES_CBC_SHA
SSL_DH_anon_WITH_3DES_EDE_CBC_SHA
SSL_DH_anon_WITH_RC4_128_MD5
SSL_DH_anon_WITH_DES_CBC_SHA
SSL_RSA_EXPORT_WITH_RC4_40_MD5
SSL_RSA_EXPORT_WITH_DES40_CBC_SHA

For more information, please see the documentation that is provided with your Oracle distribution.

Configure

To create this connection:

  • In the Import Data page, click the Plus sign. Then, select the Relational tab. Click the Oracle card. 
  • You can also create connections through the Connections page. See Connections Page.

For additional details on creating an Oracle connection, see Enable Relational Connections.

This connection can also be created using the API. 

Modify the following properties as needed:

PropertyDescription
Host
Enter your hostname. Example:

 

Code Block
testsql.database.windows.net
PortSet this value to 1521.
Connect String options

Please insert any connection options as a string here. See below.

Enable SSL

Select the option if the connection should use SSL.

Info

NOTE: Additional configuration may be required in the database server. For more information, please consult the documentation that was provided with the distribution.


Info

NOTE: Additional configuration is required. See Configure Data Service.


Service NameEnter the name of the Oracle service.
User Name(basic credential type only) Username to use to connect to the database.
Password(basic credential type only) Password associated with the above username.
Test ConnectionAfter you have defined the connection credentials type, credentials, and connection string, you can validate those credentials.
Connection NameDisplay name of the connection
Connection DescriptionDescription of the connection, which appears in the application.

Reference

Connection URL

The properties that you provide are inserted into the following URL, which connects 

D s product
 to the connection:

Code Block
<host>:<port>/<service_name>

Connect string options

The connect string options are optional. If non-standard connections are required, Oracle supports using tsnames format. 

When the connect string options field is used:

  • The connect string options parameters are prepended with jdbc:oracle:thin:@.
  • The following fields are ignored from the form. These values must be specified as part of the tsnames :
    • Host
    • Port
    • Service
    • SSL

After you specify the connect string options, the generated connection URL is automatically prepended with the following protocol information. Do not add this to the connection URL or connect string options:

Code Block
jdbc:oracle:thin:@

Examples are below.

Use SID:

If you are using a service identifier, instead of a service name, please specify your connection string options as follows:

Code Block
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=oracle.rds.example.com)(PORT=1521))(CONNECT_DATA=(SID=orcl)))

Use TCPS:

If TCPS protocol is required, you can specify your connection string options as follows:

Code Block
(DESCRIPTION=(ADDRESS=(PROTOCOL=tcps)(HOST=oracle.rds.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=orcl)))

For more information, please see the documentation for the Oracle driver.

Driver Information

This connection uses the following driver:

Troubleshooting

For more information on common error messages, see https://docs.oracle.com/cd/E11882_01/java.112/e16548/apxermsg.htm#JJDBC28962.

Use

For more information, see Database Browser.

Data Conversion

For more information on how values are converted during input and output with this database, see Oracle Data Type Conversions.