0 / 0
IBM Data Virtualization connection
IBM Data Virtualization connection

IBM Data Virtualization connection

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

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 Data Virtualization 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 Data Virtualization with an IAM API key, the Watson Query Manager of the Data Virtualization instance can add the IAM users by selecting Data > Data Virtualization > 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 Data Virtualization connections in the following workspaces and tools:


  • 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 (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 IBM Data Virtualization (Watson Knowledge Catalog).


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