0 / 0
IBM Watson Query connection
IBM Watson Query connection

IBM Watson Query connection

To access your data in Watson Query, create a connection asset for it. A Watson Query connection is created automatically in a catalog or project when you publish a virtual object to a catalog or assign it to a project. The Watson Query connection was fomerly named the Data Virtualization connection.

Watson Query integrates data sources across multiple types and locations and turns all this data into one logical data view. This virtual data view makes the job of getting value out of your data easy.

Create a Watson Query connection

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

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

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.


You can use an API key to authenticate to Watson Query in IBM Cloud.

Watson Query on IBM Cloud

First add the user ID as an IAM user or as a service ID to your IBM Cloud account. 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 Watson Query with an IAM API key, the Watson Query Manager of the Watson Query instance can add the IAM users by selecting Data > Watson Query > Administration > User management from the Cloud Pak for Data as a Service navigation menu.

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

In a project Click Assets > New asset > Data access tools > 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

Where you can use this connection

You can use Watson Query connections in the following workspaces and tools:


  • Data Refinery (Watson Studio or Watson Knowledge Catalog)
  • DataStage (DataStage service)
  • Metadata import (Watson Knowledge Catalog)
  • SPSS Modeler (Watson Studio)


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

Connected assets in governed catalogs can be used for the enforcement of data protection rules in Watson Query.


Getting started with Watson Query


You can use this connection only for source data. You cannot write to data with this connection.

Learn more

Parent topic: Supported connections