0 / 0
MongoDB connection

MongoDB connection

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

MongoDB is a distributed database that stores data in JSON-like documents.

Supported editions and versions

MongoDB editions

MongoDB versions

  • MongoDB 3.6 and later, 4.x, 5.x, and 6.x
  • Microsoft Azure Cosmos DB for MongoDB 3.6 and later, 4.x

Create a connection to MongoDB

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

  • Database name
  • Hostname or IP address
  • Port number
  • Authentication database: The name of the database in which the user was created.
  • Username and password
  • 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.

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 MongoDB 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.
  • Decision Optimization (Watson Studio and Watson Machine Learning)
  • Metadata enrichment (IBM Knowledge Catalog)
  • Metadata import (IBM Knowledge Catalog)
  • SPSS Modeler (Watson Studio)


  • Platform assets catalog

  • Other catalogs (IBM Knowledge Catalog)

Watson Query service
You can connect to this data source from Watson Query.

MongoDB setup

MongoDB installation


  • You can only use this connection for source data. You cannot write to data or export data with this connection.
  • For DataStage, table names need to be added in uppercase characters.
  • MongoDB Query Language (MQL) is not supported.

Learn more

Related connection: IBM Cloud Databases for MongoDB connection

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