MongoDB 3 driver node for Node-RED
npm install node-red-contrib-mongodb3based on node-red-bluemix-nodes and MongoDB 3 Driver
Please refer to the mongoDB node driver 'Collection' documentation to read about each operation.
msg.payload as your parameter (eg {_id: 1243})msg.payload with an array InserMany), wrap your array in an outer array: msg.payload = [[{_id: 1243}, {_id: 2345}]]Passing the last operation parameter (callbak) is not supported, and will be stripped if provided.
URI -
Using a single URI field allows you to specify Host, Port and Database configuration as well as all other features that are supported by the MongoClient.connect, such as Mongos Proxy Connection and Replicaset Server Connection - more information can be found here.
Notice that the Username & Password fields did remain. They will still be saved as Node-RED credentials (i.e. kept private). If the Username is not empty or the Password is not empty, they will be escaped and added the the URI after the mongodb:// prefix (separated by ':' and with a '@' after them). You can also leave these fields empty and enter the credentials directly in the URI, following the standard syntax: mongodb://youruser:yourpassword@host1.yourmongoprovider.com:27017,host2.yourmongoprovider.com:27017/yourdb?replicaSet=foo. Do not enter your credentials both in the URI and the Username & Password fields - this will create an invalid URI such as: mongodb://youruserfromfield:yourpasswordformfield@youruserfromuri:yourpasswordfromuri@host1.yourmongoprovider.com:27017,host2.yourmongoprovider.com:27017/yourdb?replicaSet=foo.
specifying authentication database -
most recent deployments of mongoDB store user credentials in a separate databse (usually admin) rather than allongside the data in each Db. Therefore you will likley need to provide a authSource parameter in your URI
eg: mongodb://host1.yourmongoprovider.com:27017/yourdb?ssl=true&authSource=admin&replicaSet=foo
Parallelism Limit - Sending a lot of commands in a short time to the underlying mongodb-native driver, without waiting for their response, may cause serious problems and slow down the whole app.
This has probably something to do with the connection sockets being clogged and their cache getting filled.
This option allows to limit the number of operations that are sent before getting a response.
For example, if the parallelism-limit is set to 5 and we are making 7 operations in a short period of time, the first 5 operations will start immediately, but the 6th and 7th operations will wait in a queue.
The 6th operation will start only when one of the first 5 operations has finished.
Similarly, the 7th operation will start only when another operation has finished.
db & collection operations - These operations will simply pass the db/collection instance, so they can be used directly (for example, in function nodes).
The db instance is the same one that node-red-contrib-mongodb3 caches and shares between all relevant nodes - if you disconnect it, all the other mongodb3 nodes will fail.
Furthermore, the parallelism-limit does not consider the future operations that you will do with the db/collection instances.
However, if there are many parallel operations, requesting the db/collection will block until some of these operations finish.
1.0 message shape:
``
msg
|_ payload
|_ ok
|_ n
|_ opTime
|_ electionId
|_ operationTime
|_ "$clusterTime message shape (example for find()): `
msg
|_ payload
|_ insertedCount
|_ ops
|_ insertedIds
|_ result
|_ ok
|_ n
|_ opTime
|_ electionId
|_ operationTime
|_ "$clusterTime
``