{"id":9903,"date":"2025-04-10T17:49:33","date_gmt":"2025-04-11T00:49:33","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cosmosdb\/?p=9903"},"modified":"2025-04-10T17:49:33","modified_gmt":"2025-04-11T00:49:33","slug":"getting-insights-from-changes-to-items-in-azure-cosmos-db-just-got-easier","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cosmosdb\/getting-insights-from-changes-to-items-in-azure-cosmos-db-just-got-easier\/","title":{"rendered":"Getting insights from changes to items in Azure Cosmos DB just got easier!"},"content":{"rendered":"

Azure Cosmos DB\u2019s change feed provides a view of changes to data in your container. This enables patterns like event sourcing, auditing and synchronizing downstream systems. Change feed can be read in real time or on demand, giving you the most flexibility for processing and reprocessing changes.<\/p>\n

Change feed is available in two modes, latest version mode and all versions and deletes mode. The all versions and deletes mode Public Preview is now easier to use and you can enable it directly on your accounts without registering your subscription! Latest version mode gives you changes from create and update operations, while all versions and deletes mode gives you these changes in addition to changes from delete operations. It also provides metadata to identify if a given change is from a create, update or delete. With all versions and deletes change feed mode, you can read every change that occurred in your container within the continuous backup<\/a> retention period configured.<\/p>\n

Enable all versions and deletes change feed mode<\/h2>\n

In your Azure Cosmos DB account, navigate to the Features page to enable the all versions and deletes change feed mode Public Preview. Before enabling, ensure your account has turned on continuous backups. The enablement process can take up to 30 minutes, after which you\u2019ll be able to read change feed in all versions and deletes mode!<\/p>\n

\"Image<\/a><\/p>\n

If you prefer programmatic deployments, you can update your Azure Cosmos DB account with the az cli<\/a> or Bicep<\/a>. Here\u2019s an example using the az cli to enable all versions and deletes mode on an existing account.<\/p>\n

    \n
  1. Create variables with values for your Azure Cosmos DB account.<\/li>\n<\/ol>\n
    # Azure Cosmos DB account name\r\n$accountName = \"my-cosmos-db-account-name\"\r\n\r\n# Resource group name for your Azure Cosmos DB account\r\n$resourceGroupName = \"resource-group-with-my-cosmos-db-account \"\r\n\r\n# Subscription id for your Azure Cosmos DB account\r\n$subscriptionId = \"my-subscription-id\"\r\n\r\n# Combine variables to create the accountId for later use\r\n$accountId = \"\/subscriptions\/$subscriptionId\/resourceGroups\/$resourceGroupName\/providers\/Microsoft.DocumentDB\/databaseAccounts\/$accountName\"<\/code><\/pre>\n
      \n
    1. Create a file named capabilities.json<\/code> with the following content.<\/li>\n<\/ol>\n
      {\r\n    \"properties\": {\r\n        \"enableAllVersionsAndDeletesChangeFeed\": true\r\n    }\r\n}<\/code><\/pre>\n
        \n
      1. Use the az cli to make a REST call enabling all versions and deletes change feed mode on your account.<\/li>\n<\/ol>\n
        az rest --method PATCH --uri \"https:\/\/management.azure.com$accountId\/?api-version=2024-12-01-preview\" --body @capabilities.json --headers content-type=application\/json<\/code><\/pre>\n
        Get Started with the SDKs<\/h2>\n
        We\u2019ve also recently added support for all versions and deletes mode in more SDKs! The .NET, Java, Python and JavaScript SDKs all provide APIs for using all versions and deletes change feed mode. Whether you’re building applications in any of these languages, you can now seamlessly integrate change feed functionality into your projects! Visit the documentation<\/a> for examples of how to read change feed in with each SDK.<\/p>\n
        Here’s an example how to read change feed using all versions and deletes mode in Python. The full Python sample can be found on GitHub<\/a>.<\/p>\n
        # Initialize CosmosClient\r\ncredential = DefaultAzureCredential()\r\nclient = cosmos_client.CosmosClient(ENDPOINT, credential=credential)\r\n\r\n# Connect to database and container\r\ndb = client.get_database_client(DATABASE_ID)\r\ncontainer = db.get_container_client(CONTAINER_ID)\r\n\r\n# Read all change feed with 'AllVersionsAndDeletes' mode\r\nresponse_iterator = container.query_items_change_feed(mode=\"AllVersionsAndDeletes\")\r\nfor doc in response_iterator:\r\n    print(doc)\r\n\r\n# Save the continuation token for future iterations\r\ncontinuation_token = container.client_connection.last_response_headers['etag']<\/code><\/pre>\n
        Learn more<\/h2>\n