Important:

IBM Cloud Pak® for Data Version 4.8 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.
Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.8 reaches end of support. For more information, see Upgrading from IBM Cloud Pak for Data Version 4.8 to IBM Software Hub Version 5.1.

IBM Cloudant connection

To access your data in IBM Cloudant, create a connection asset for it.

Cloudant is a JSON document database available in IBM Cloud.

Create a connection to Cloudant

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

  • URL to the Cloudant database
  • Database name
  • Username and password

For Credentials, 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 > 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 Cloudant connections in the following workspaces and tools:

Projects

  • Data Refinery (Watson Studio or IBM Knowledge Catalog)
  • Notebooks (Watson 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.
  • Decision Optimization (Watson Studio and Watson Machine Learning)
  • SPSS Modeler (SPSS Modeler service)
  • Synthetic Data Generator (Synthetic Data Generator service)
  • Watson Machine Learning Accelerator (Watson Machine Learning Accelerator service)

Catalogs

  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

Federal Information Processing Standards (FIPS) compliance

  • 4.8.0 and 4.8.1: This connection is compliant with FIPS if you installed Cloud Pak for Data on or prior to January, 22, 2024.
  • 4.8.2 and later: This connection is not compliant with FIPS, but it is FIPS-tolerant.

Cloudant setup

To set up the Cloudant database on IBM Cloud, see Getting started with IBM Cloudant.
When you create your Cloudant service, for Authentication method, select IAM and legacy credentials.

Restriction

IBM Cloud Query (CQ) is not supported.

Learn more

IBM Cloudant docs

Parent topic: Supported connections