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

Create a connection to Db2 Warehouse

If you have set up an integrated cloud service, select the service instance to automatically fill in the fields in the connection form. Confirm that all the fields are complete.

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

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

SSL certificate (if required by the database server)

Credentials

If you select Shared, enter either an API key or a username and password. for the server.

If you select Personal, you have two choices:

Enter your username and password for the server.
Select platform login credentials.
You can use this option only if the Db2 service is hosted on the instance of Cloud Pak for Data that you are connecting to.

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

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.
In a catalog: Click Add to catalog > Connection. See Adding a connection asset to a catalog.
In a deployment space: Click Import assets > Data access > Connection. See Adding data assets to a deployment space.
In the Platform assets catalog: Click New connection. See Adding platform connections.

Next step: Add data assets from the connection

Where you can use this connection

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

Projects

Cognos Dashboards (Cognos Dashboard Embedded service)
Data Replication (Data Replication service). You can replicate data from other databases to Db2 Warehouse using Data Replication. See Replicating Db2 Warehouse data.
Data Refinery (watsonx.ai Studio or IBM Knowledge Catalog)
DataStage (DataStage service). See Connecting to a data source in DataStage.
Decision Optimization (watsonx.ai Studio and watsonx.ai Runtime)
Metadata enrichment (IBM Knowledge Catalog)
Metadata import (IBM Knowledge Catalog)
Notebooks (watsonx.ai Studio). 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.
SPSS Modeler (watsonx.ai Studio)

Catalogs

Platform assets catalog
Other catalogs (IBM Knowledge Catalog)

Watson Query service: You can connect to this data source from Watson Query.

Db2 Warehouse setup

IBM Db2 Warehouse on Cloud: Getting started with Db2 Warehouse on Cloud
IBM Db2 Warehouse on-prem: Setting up 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

Parent topic: Supported connections