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:

• IBM Db2 Warehouse in IBM Cloud
• IBM Db2 Warehouse on-prem
• IBM Db2 Warehouse instance on Cloud Pak for Data

Create a connection to Db2 Warehouse

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

• Database name
• Hostname or IP address of the database server
• Port number
• API key
• Username and password
• SSL certificate (if required by the database server)

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 or to a Db2 Warehouse instance on Cloud Pak for Data.

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

Db2 Warehouse instance on Cloud Pak for Data
Enter the API key value withthis syntax: user_name:api_key.
For more information, see the Cloud Pak for Data Db2 Warehouse documentation for User credentials and supported authentication methods.

For Credentials and Certificates, you can use secrets if a vault is configured for the platform and the service supports vaults. For information, see Using secrets from vaults in connections.

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

In a project Click Add to project > Connection. See Adding a connection to a project.

In a catalog Click Add to catalog > Connection. See Adding a connection asset to a catalog.

In a deployment space Click Add to space > Connection. See Adding connections to a deployment space.

In the Platform assets catalog Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

• See Add data from a connection in a project.
• See Add data from a connection in a catalog.

Where you can use this connection

You can use Db2 Warehouse connections in the following workspaces and tools:

Analytics projects

• Cognos Dashboards (Watson Studio)
• Data Refinery (Watson Studio or Watson Knowledge Catalog)
• DataStage (DataStage service)
• Metadata import (Watson Knowledge Catalog)
• Notebooks (Watson Studio). Use the insert-to-code function to get the connection credentials and load the data into a data structure. See Load data from data source connections.
• SPSS Modeler (SPSS Modeler service)

Catalogs

• Platform assets catalog
• Other catalogs (Watson Knowledge Catalog)

Data Virtualization service You can connect to this data source from Data Virtualization.

Db2 Warehouse setup

• IBM Db2 Warehouse on Cloud: Getting started with Db2 Warehouse on Cloud
• IBM Db2 Warehouse on-prem: Setting up Db2 Warehouse
• IBM Db2 Warehouse instance on Cloud Pak for Data: Installing Db2 Warehouse

Running SQL statements

To ensure that your SQL statements run correctly, refer to the product documentation in Learn more for the correct syntax.

Known issue

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

Learn more

• IBM Db2 Warehouse on Cloud product documentation (IBM Cloud)
• IBM Db2 Warehouse on-prem product documentation
• IBM Db2 Warehouse instance on Cloud Pak for Data product documentation

Parent topic: Supported connections