MongoDB setup guide

Follow these steps to use MongoDB Server as your source.

Prerequisite - Configure MongoDB for CDC

Upsolver supports ingesting CDC data from relational databases including MongoDB. Upsolver provides CDC capabilities by running a Debezium Engine under the hood. Connectors detect and ingest changes automatically.

Before you ingest data into Upsolver, you must enable change data capture on your MongoDB database. If you are using a managed MongoDB service such as Atlas, CDC is most likely to be enabled, if not, please refer to the guide to Deploy a Replica Set for more information

Step 1 - Connect to your MongoDB

Select an existing MongoDB connection, or create a new one.

Create a new MongoDB connection

Connection String

Enter your connection string in the following format:

mongodb+[srv]://HOST

where:

  • HOST - the hostname or IP address of the MongoDB Server instance you want to connect to, for example, my-mongo.mongodb.net.

Optional: Username and Password

Provide the username and password to authenticate to the database.

Step 2 - Select databases and collections

There are two ways to replicate objects to the target:

  1. Manually select the databases and collections.

  2. Use regular expressions to specify which databases and collections are included and excluded.

The following examples show how to use a regular expression to include specific collections:

ExpressionResults

db_name.*

Select all collections in the db_name database.

db_name.users,

db_name.items

Select users and items collections in the db_name database.

db_name.items_.*

Select all collections in the db_name database that start with items_.

"my.db".*

Select all collections in the my.db database.

If the name of the database or collection that you want to include contains a dot (.) in the name of the database or collection, you must escape each part of the name in double quotes.

Note: the following databases are internal MongoDB system databases and therefore they will not be replicated:

  • admin

  • local

  • config

Schema evolution

By default, new databases, collections, and fields added after the job is launched, will be replicated to the target.

You can overwrite the default behavior and set specific behavior for newly created databases or collections in a specific database.

Last updated