# IBM Db2 Warehouse connection #

To access your data in IBM Db2 Warehouse, create a connection asset for it\.

IBM Db2 Warehouse is an analytics data warehouse that gives you a high level of control over your data and applications\. You can use the IBM Db2 Warehouse connection to connect to a database in these products:

<!-- <ul> -->

 *  IBM Db2 Warehouse in IBM Cloud
 *  IBM Db2 Warehouse on\-prem

<!-- </ul> -->

## Create a connection to Db2 Warehouse ##

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

<!-- <ul> -->

 *  **Database name**
 *  **Hostname or IP address** of the database server
 *  **Port number**
 *  **API key** or **Username** and **password**
 *  **Application name** (optional): The name of the application that is currently using the connection\. For information, see [Client info properties support by the IBM Data Server Driver for JDBC and SQLJ](https://www.ibm.com/docs/SSEPGG_11.5.0/Javadocs/src/tpc/imjcc_r0052001.html)\.
 *  **Client accounting information** (optional): The value of the accounting string from the client information that is specified for the connection\. For information, see [Client info properties support by the IBM Data Server Driver for JDBC and SQLJ](https://www.ibm.com/docs/SSEPGG_11.5.0/Javadocs/src/tpc/imjcc_r0052001.html)\.
 *  **Client hostname** (optional): The hostname of the machine on which the application that is using the connection is running\. For information, see [Client info properties support by the IBM Data Server Driver for JDBC and SQLJ](https://www.ibm.com/docs/SSEPGG_11.5.0/Javadocs/src/tpc/imjcc_r0052001.html)\.
 *  **Client user** (optional): The name of the user on whose behalf the application that is using the connection is running\. For information, see [Client info properties support by the IBM Data Server Driver for JDBC and SQLJ](https://www.ibm.com/docs/SSEPGG_11.5.0/Javadocs/src/tpc/imjcc_r0052001.html)\.
 *  **SSL certificate** (if required by the database server)

<!-- </ul> -->

### Credentials ###

For Credentials, you can enter either an API key or a username and password

#### Authenticating with an API Key ####

You can use an API key to authenticate to Db2 Warehouse in IBM Cloud\.

**Db2 Warehouse in IBM Cloud**  
First add the user ID as an IAM user or as a service ID\. For instructions, see **the Console user experience** section of the [Identity and access management (IAM) on IBM Cloud](https://cloud.ibm.com/docs/Db2whc?topic=Db2whc-iam#console-ux) topic\.

If users want to authenticate with Db2 Warehouse with an IAM API key, the administrator of the Db2 Warehouse instance can add the IAM users by using the User management console, and then the users can each create an API key for themselves by using the IAM access management console\.

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**\. 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 Db2 Warehouse connections in the following workspaces and tools:

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization
 *  Notebooks\. Click **Read data** on the **Code snippets** pane to get the connection credentials and load the data into a data structure\. See [Load data from data source connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/load-and-access-data.html#conns)\.
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Db2 Warehouse setup ##

<!-- <ul> -->

 *  IBM Db2 Warehouse on Cloud: [Getting started with Db2 Warehouse on Cloud](https://cloud.ibm.com/docs/Db2whc?topic=Db2whc-getting-started)
 *  IBM Db2 Warehouse on\-prem: [Setting up Db2 Warehouse](https://www.ibm.com/docs/SSCJDQ/com.ibm.swg.im.dashdb.doc/admin/local_setup.html)

<!-- </ul> -->

### Running SQL statements ###

To ensure that your SQL statements run correctly, refer to the product documentation in [Learn more ](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-db2-wh.html?context=cdpaas&locale=en#lm) for the correct syntax\.

## Known issue ##

On Data Refinery, system\-level schemas aren’t filtered out\.

## Learn more ##

<!-- <ul> -->

 *  IBM Db2 Warehouse on Cloud [product documentation](https://cloud.ibm.com/docs/Db2whc) (IBM Cloud)
 *  IBM Db2 Warehouse on\-prem [product documentation](https://www.ibm.com/docs/SSCJDQ/com.ibm.swg.im.dashdb.doc/local_overview.html)

<!-- </ul> -->

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

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