node-red-cosmos-r2 1.0.1
A Node-RED custom node that connects to a Cosmos DB and performs create, update, read, delete, and upsert operations.
node-red-cosmos-r2
A Node-RED custom node that connects to a Cosmos DB and performs create, update, read, delete, and upsert operations.
Installation
Install the node-red-cosmos-r2 node from the command line:
npm install node-red-cosmos-r2
Then, restart your Node-RED instance to load the new node.
Features
- Connect to Cosmos DB using URI, Key, Database ID, and Container ID
- Perform create, read, update, delete, and upsert operations
- Configure operations using input messages
Usage
Add the cosmos-r2 node to your Node-RED flow and configure it with the following properties:
- Name: (Optional) A custom name for the node
- URI: The Cosmos DB endpoint URI
- Key: The Cosmos DB key
- Database ID: The Cosmos DB database ID
- Container ID: The Cosmos DB container ID
The input message must contain the following properties:
operation
: The type of operation to perform, either "create", "read", "update", "delete", or "upsert"item
: (Optional) The item to create, update, delete, or upsert. Required for "create", "update", "delete", and "upsert" operationsquery
: (Optional) A query to filter items for "read" operation. If not provided, all items will be retrieved
The output message will contain the following property:
payload
: The result of the operation, such as created, read, updated, deleted, or upserted items
Examples
Create an item:
{
"operation": "create",
"item": {
"id": "1",
"name": "Example Item"
}
}
Read items:
{
"operation": "read",
"query": "SELECT * FROM c WHERE c.name = 'Example Item'"
}
Update an item:
{
"operation": "update",
"item": {
"id": "1",
"name": "Updated Item"
}
}
Delete an item:
{
"operation": "delete",
"item": {
"id": "1"
}
}
Upsert an item:
{
"operation": "upsert",
"item": {
"id": "1",
"name": "Upserted Item"
}
}