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 or Username and password
  • SSL certificate (if required by the database server)

Connecting to a Db2 Warehouse instance on Cloud Pak for Data

If you are connecting to a Db2 Warehouse instance that is in the same instance in Cloud Pak for Data, you can run this command to obtain the hostname and port number:

oc get svc | grep db2

The hostname is the Db2 Warehouse service name. The service name always starts with c-db2wh, for example c-db2wh-1605022957148004-db2u-engn-svc.

The port number is 50000 for a non-SSL connection or 50001 for an SSL connection.

Credentials

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

If you select Personal, you have one of three choices:

  • Enter your credentials manually.
  • Use secrets from a vault.
  • 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 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 Assets > New asset > Prepare data > 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

Catalogs

  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

Data Product Hub
You can connect to this data source from Data Product Hub. For instructions, see Connectors for Data Product Hub.
Data Virtualization service
You can connect to this data source from Data Virtualization.

Federal Information Processing Standards (FIPS) compliance

This connection can be used on a FIPS-enabled cluster (FIPS tolerant); however, it is not FIPS-compliant.

Db2 Warehouse setup

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

Parent topic: Supported connections