Updated on 2025-07-21 GMT+08:00

MongoDB Connection Parameters (Internal Test)

Table 1 MongoDB connection

Parameter

Mandatory

Description

Data Connection Type

Yes

MongoDB is selected by default and cannot be changed.

Name

Yes

Name of the data connection to create. Data connection names can contain a maximum of 100 characters. They can contain only letters, digits, underscores (_), and hyphens (-).

Description

No

A description which can help identify the data connection more easily. It can contain a maximum of 100 characters.

Tag

No

Attribute of the data connection to create. Tags make management easier.
NOTE:

The tag name can contain only letters, digits, and underscores (_) and cannot start with an underscore (_) or contain more than 100 characters.

Applicable Modules

Yes

Select the modules for which this connection is available.

NOTE:
  • When offline or real-time data migration jobs are enabled, you can select the DataArts Migration module. Then you can select this data connection when creating a data migration job in DataArts Factory.
  • You can use offline or real-time data migration jobs only after you apply for the whitelist membership. To use this feature, contact customer service or technical support.

Basic and Network Connectivity Configuration

Server List

Yes

One or more servers (server domain name/IP address:server port) separated by commas (,)

Example: 192.168.0.1:27017 or 192.168.0.2:27017

KMS Key

Yes

KMS key used to encrypt and decrypt data source authentication information. Select a default or custom key.
NOTE:
  • When you use KMS for encryption through DataArts Studio or KPS for the first time, the default key dlf/default or kps/default is automatically generated. For more information about default keys, see What Is a Default Master Key?.
  • Only symmetric keys are supported. Asymmetric keys are not supported.

Agent

Yes

DataArts Studio cannot directly connect to non-fully managed services. An agent is required for DataArts Studio to communicate with non-fully managed services. A CDM cluster can function as an agent. If no CDM cluster is available, create one by referring to Creating a CDM Cluster.

Data Migration Configuration

Database Name

Yes

Name of the database to be connected If you enter rwuser for username, enter admin for Database Name.

Is direct connection mode

No

Whether to enable the direct connection mode. This mode applies to the scenario where the network of the primary node is normal but the network of the replica node is abnormal.

Properties

No

Custom connection attributes, in milliseconds. socketTimeout, maxWaitTime, connectTimeout, and serverSelectionTimeout are supported.

Example: socketTimeout=60000.

Data Source Authentication and Other Function Configuration

Username

Yes

Username for logging in to MongoDB

Password

Yes

Password for logging in to MongoDB