| D s ed |
|---|
| r | true |
|---|
| editions | gdpent,gdppro,gdppr,gdpst,awsent,awspro,awspr,awsst |
|---|
|
| Excerpt |
|---|
You can create connections to one or more from . |
| D s oracle type inference |
|---|
If you are connecting
to any relational source of data, such as
or
, you must add the
to your whitelist for those resources. See
Whitelist Platform Service.
Supported Versions: 12.1.0.2
- Read: Supported
- Write: Supported
To create this connection:
- In the Import Data page, click the Plus sign. Then, select the Relational tab. Click the card.
- You can also create connections through the Connections page. See Connections Page.
Modify the following properties as needed:
| Property | Description |
|---|
| Host | Enter your hostname. Example:
| Code Block |
|---|
testsql.database.windows.net |
|
| Port | Set 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: SSL connections are not supported in . |
|
| Service Name | Enter 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 Connection | After you have defined the connection credentials type, credentials, and connection string, you can validate those credentials. |
| Advanced options: Enable SSH Tunneling |
If available, the SSH tunneling options allow you to configure SSH tunneling authentication between the and your database. | Info |
|---|
NOTE: SSH tunneling is available on a per-connection basis. It may not be available for all connections. |
For more information, see Configure SSH Tunnel Connectivity. |
| Connection Name | Display name of the connection |
| Connection Description | Description of the connection, which appears in the application. |
Connection URL
The properties that you provide are inserted into the following URL, which connects
to the connection:
| Code Block |
|---|
<host>:<port>/<service_name> |
Connect string options
The connect string options are optional. If non-standard connections are required,
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 :
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
driver.
This connection uses the following driver:
Create via API
This connection can also be created using the API.
For more information, see
| D s api refdoclink |
|---|
#operation/createConnection |
Troubleshooting
For more information on common error messages, see https://docs.oracle.com/cd/E11882_01/java.112/e16548/apxermsg.htm#JJDBC28962.
"Could not create dataset - Lexical error"
When you attempt to create a dataset with SQL from an Oracle database, you may receive an ORA error similar to the above. These queries may work in other database tools.
Solution:
The solution is to apply aliasing impacted columns in your SQL query. For more information, see Supported SQL Syntax.
Use
SQL Syntax
The following syntax requirements apply to this connection.
Object delimiter: double-quote
Example syntax:
Double quotes required around database and table names and not required around column names.
| Code Block |
|---|
SELECT "column1","column2" FROM "databaseName"."tableName"; |
For more information on SQL in general, see Supported SQL Syntax.
Data Conversion
For more information on how values are converted during input and output with this database, see Oracle Data Type Conversions.
