---
title: DB - MongoDB
slug: manufacturing-connect-edge/db-mongodb
docTags: 
createdAt: 2023-12-01T19:35:12.163Z
---

Review the [MongoDB Integration Guide](docId\:p148zBzLCmhQj1QizHM43).&#x20;

## Overview

MongoDB integration enables an Edge System to connect with a MongoDB database.&#x20;

## Supported Versions

- MongoDB 2.x - MongoDB 3.2

## Supported Communication

- Outbound (Edge to Database) - Yes
- Inbound (Database to Edge) - No

## Configurations

| **Variable**         | **Detail**                                                                                                                                                                                                                                                                                                   | **Required** |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ |
| Name                 | Enter a name for the connector                                                                                                                                                                                                                                                                               | Yes          |
| Hostname             | IP Address or Hostname of MongoDB Server (Must be reachable from the Edge system)                                                                                                                                                                                                                            | Yes          |
| Port                 | MongoDB Server port                                                                                                                                                                                                                                                                                          | Yes          |
| Username             | User name                                                                                                                                                                                                                                                                                                    | No           |
| Password             | User password                                                                                                                                                                                                                                                                                                | No           |
| Auth database        | Authentication database name                                                                                                                                                                                                                                                                                 | No           |
| Auth mechanism       | Authentication mechanism (can be one of "SCRAM-SHA-1", "MONGODB-CR", "MONGO-CR", "PLAIN", "MONGODB-X509")                                                                                                                                                                                                    | No           |
| Database             | Database name. If database does not exist it is created.                                                                                                                                                                                                                                                     | Yes          |
| Collection           | Collection name. If collection does not exist it is created.                                                                                                                                                                                                                                                 | Yes          |
| Show Mapping         | Data from a predefined table could be mapped into a custom one. Example: \{"from": "to"} where "from" is a column from predefined table, and "to" is a column from destination table. See [Work with Tables in SQL Connectors (Create Table and Show Mapping)](docId\:FI9mBipRrRIxufdIHwQl9) to learn more.  |              |
| Commit timeout       | Transaction commit timeout (ms)                                                                                                                                                                                                                                                                              | No           |
| Max transaction size | Maximum number of messages before a transaction is committed regardless of timeout                                                                                                                                                                                                                           | No           |
| Throttling limit     | Set a limit on the number of outbound messages per second. If sending data to a server that has restrictions on the rate of incoming messages, this ensures that no messages are lost.                                                                                                                       | No           |
| Queue mode           | Select the sequence of data transfer: FIFO or LIFO. Selecting FIFO (First In First Out) will send the earliest message first. Selecting LIFO (Last In First Out) will send the latest message first.                                                                                                         | No           |
| Persistent storage   | If enabled, messages in the outbound queue are stored on disk. If there are interruptions in connection or power loss, messages will be retained and eventually sent when the connection is restored.                                                                                                        | No           |

