Supported Versions: 

• Database versions: 2.6 - 5.0

Supported Environments:

Prerequisites

• MongoDB supports basic (username/password) authentication.

Limitations

• This connection is read-only.

Create Connection

MongoDB

To create a MongoDB connection, please specify the following properties:

Timeout=0;

MongoDB Atlas

To create a MongoDB Atlas connection, please specify the following properties:

Timeout=0;

For more information on these settings, see http://cdn.cdata.com/help/RCF/jdbc/default.htm.

Create connection via API

Depending on your product edition, you can create connections of this type.

MongoDB:

"vendor": "mongodb",
"vendorName": "MongoDB",
"type": "jdbc"

MongoDB Atlas:

"vendor": "mongodb_atlas",
"vendorName": "MongoDB Atlas",
"type": "jdbc"

operation/createConnection

Connect string options

Connection timeout

By default, the supported driver applies a connection timeout to MongoDB of 0 seconds. As needed, you can modify the connection timeout through connect string options:

Timeout=<value_in_seconds>;

where:

<value_in_seconds> corresponds to the number of seconds for the time. 

Flattening Documents

Documents can contain other documents, which enables the storage of nested data. You can control the flattening of nested objects and arrays through the CData driver through Connect String Options.

Flatten Objects:

By default, the CData driver flattens nested Objects. As needed, you can set FlattenObjects to  false  to disable this behavior.

For more information, see http://cdn.cdata.com/help/DGF/jdbc/RSBMongodb_p_FlattenObjects.htm.

Flatten Arrays:

By default, CData driver does not flatten Arrays.

• As needed, you can configure the number of elements that you want to have returned in your flattened arrays.  
• To flatten all elements of all arrays, set FlattenArrays to -1.

For more information, see http://cdn.cdata.com/help/DGF/jdbc/RSBMongodb_p_FlattenArrays.htm.

Referencing flattened columns:

If you have flattened Objects or Arrays, you can reference these columns using square brackets in your custom SQL queries.

Example of flattened Object:

SELECT [address.city] FROM my_table;

Example of flattened Array:

SELECT * FROM my_table WHERE [hobbies.0]='cricket';

Driver Information

For more information on CData JDBC drivers, see http://cdn.cdata.com/help/DGF/jdbc/default.htm.

Using MongoDB

MongoDB is a NoSQL document database that provides high performance, availability, and scalability. 

MongoDB Data Organization Hierarchy

MongoDb has a two-level data hierarchy:

+ Schema1
  + Collection1
  + Collection2
+ Schema2
  + Collection3
  + Collection4

• Schema roughly corresponds to a database.
• Collection roughly corresponds to a table.
  • A collection is composed of documents. A Document is a binary JSON representation of the fields and values of a row. 

Database Uses

For more information on interacting with databases, see Using Databases.

Read Data

You can import datasets from MongoDB through the Import Data page. See  Import Data Page .

Data Type Mappings

Access/Read

When data is imported from MongoDB, the supported data types from the source are converted to corresponding data types supported by the 

Write/Publish

Not supported.