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 5.0 and later
  • MongoDB 4.0 and later
  • MongoDB 3.6 and later
  • Microsoft Azure Cosmos DB for MongoDB 4.0 and later
  • Microsoft Azure Cosmos DB for MongoDB 3.6 and later

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

Projects

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

Catalogs

  • Platform assets catalog

  • Other catalogs (Watson Knowledge Catalog)

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

Federal Information Processing Standards (FIPS) compliance

The MongoDB connection cannot be created in a FIPS environment.

MongoDB setup

MongoDB installation

Restrictions

  • 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