Serverless event-based architectures with Azure Cosmos DB and Azure Functions


Azure Functions provides the simplest way to connect to the change feed. You can create small reactive Azure Functions that will be automatically triggered on each new event in your Azure Cosmos container's change feed.

Serverless event-based Functions working with the Azure Functions trigger for Cosmos DB

With the Azure Functions trigger for Cosmos DB, you can leverage the Change Feed Processor's scaling and reliable event detection functionality without the need to maintain any worker infrastructure. Just focus on your Azure Function's logic without worrying about the rest of the event-sourcing pipeline. You can even mix the Trigger with any other Azure Functions bindings.


Currently, the Azure Functions trigger for Cosmos DB is supported for use with the Core (SQL) API only.


To implement a serverless event-based flow, you need:

  • The monitored container: The monitored container is the Azure Cosmos container being monitored, and it stores the data from which the change feed is generated. Any inserts, updates to the monitored container are reflected in the change feed of the container.
  • The lease container: The lease container maintains state across multiple and dynamic serverless Azure Function instances and enables dynamic scaling. This lease container can be manually or automatically created by the Azure Functions trigger for Cosmos DB. To automatically create the lease container, set the CreateLeaseCollectionIfNotExists flag in the configuration. Partitioned lease containers are required to have a /id partition key definition.

Create your Azure Functions trigger for Cosmos DB

Creating your Azure Function with an Azure Functions trigger for Cosmos DB is now supported across all Azure Functions IDE and CLI integrations:

Run your trigger locally

You can run your Azure Function locally with the Azure Cosmos DB Emulator to create and develop your serverless event-based flows without an Azure Subscription or incurring any costs.

If you want to test live scenarios in the cloud, you can Try Cosmos DB for free without any credit card or Azure subscription required.

Next steps

You can now continue to learn more about change feed in the following articles: