0 / 0
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 formerly 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:


Connecting to a Watson Query instance in IBM Cloud

  • API key: Enter an IAM API key. Prerequisites:
    1. 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.
    2. The Watson Query Manager of the Watson Query instance must add IAM users by selecting Data > Watson Query > Administration > User management from the Cloud Pak for Data as a Service navigation menu.

Connecting to a Watson Query instance in Cloud Pak for Data (on-prem)

  • User credentials: Enter your Cloud Pak for Data username and password.
  • API key: Enter an API key value with your Cloud Pak for Data username and a Cloud Pak for Data API key. Use this syntax: user_name:api_key

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 > 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 quality rules (IBM Knowledge Catalog)
  • Data Refinery (Watson Studio or IBM Knowledge Catalog)
  • DataStage (DataStage service). See Connecting to a data source in DataStage.
  • Metadata enrichment (IBM Knowledge Catalog)
  • Metadata import (IBM Knowledge Catalog)


  • Platform assets catalog

  • Other catalogs (IBM 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

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more