# Oracle connection #

To access your data in Oracle, you must create a connection asset for it\.

Oracle is a multi\-model database management system\.

## Supported versions ##

<!-- <ul> -->

 *  Oracle 19c and 21c

<!-- </ul> -->

## Create a connection to Oracle ##

To create the connection asset, you need the following connection details:

<!-- <ul> -->

 *  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]]]]...)`  
      
    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\.

<!-- </ul> -->

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](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/securingconn.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. For more information, see [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Oracle connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Oracle setup ##

[Oracle installation](https://docs.oracle.com/cd/E11882_01/server.112/e10897/install.htm#ADMQS002)

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the [Oracle Supported SQL Syntax and Functions](https://docs.oracle.com/en/database/oracle/oracle-database/21/gmswn/database-gateway-sqlserver-supported-sql-syntax-functions.html) for the correct syntax\.

## Learn more ##

[Oracle product documentation](https://docs.oracle.com/en/database/)

**Parent topic:**[Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->