Merge pull request #202701 from t-khelan/changes-log

Change log

Author: v-dirichards

articles/cosmos-db/mongodb/TOC.yml

@@ -258,6 +258,8 @@
           href: ../data-residency.md?toc=/azure/cosmos-db/mongodb/toc.json
     - name: Automatic recommendations
       href: ../automated-recommendations.md?toc=/azure/cosmos-db/mongodb/toc.json
+    - name: Change log
+      href: change-log.md
     - name: API version 4.2
       href: feature-support-42.md
     - name: API version 4.0

articles/cosmos-db/mongodb/change-log.md

@@ -0,0 +1,83 @@
+---
+title: Change log for Azure CosmosDB API for MongoDB
+description: Notifies our customers of any minor/medium updates that were pushed
+ms.service: cosmos-db
+ms.subservice: cosmosdb-mongo
+ms.topic: overview
+ms.date: 06/22/2022
+author: t-khelan
+ms.author: t-khelanmodi
+---
+
+# Change log for Azure Cosmos DB API for MongoDB
+The Change log for the API for MongoDB is meant to inform you about our feature updates. This document covers more granular updates and complements [Azure Updates](https://azure.microsoft.com/updates/).
+
+## Cosmos DB's API for MongoDB updates
+
+### Azure Data Studio MongoDB extension for Azure Cosmos DB (Preview)
+You can now use the free and lightweight tool feature to manage and query your MongoDB resources using mongo shell. Azure Data Studio MongoDB extension for Azure Cosmos DB allows you to manage multiple accounts all in one view by 
+1. Connecting your Mongo resources 
+2. Configuring the database settings 
+3. Performing create, read, update, and delete (CRUD) across Windows, macOS, and Linux. 
+
+[Learn more](https://aka.ms/cosmosdb-ads)
+
+
+### Linux emulator with Azure Cosmos DB API for MongoDB 
+The Azure Cosmos DB Linux emulator with API for MongoDB support provides a local environment that emulates the Azure Cosmos DB service for development purposes on Linux and macOS. Using the emulator, you can develop and test your MongoDB applications locally, without creating an Azure subscription or incurring any costs. 
+
+[Learn more](https://aka.ms/linux-emulator-mongo)
+
+
+### 16-MB limit per document in API for MongoDB (Preview)
+The 16-MB document limit in the Azure Cosmos DB API for MongoDB provides developers the flexibility to store more data per document. This ease-of-use feature will speed up your development process in these cases. 
+
+[Learn more](./mongodb-introduction.md)
+
+
+### Azure Cosmos DB API for MongoDB data plane Role-Based Access Control (RBAC) (Preview)
+The API for MongoDB now offers a built-in role-based access control (RBAC) that allows you to authorize your data requests with a fine-grained, role-based permission model. Using this role-based access control (RBAC) allows you access with more options for control, security, and auditability of your database account data.
+
+[Learn more](./how-to-setup-rbac.md)
+
+
+### Unique partial indexes in Azure Cosmos DB API for MongoDB 
+The unique partial indexes feature allows you more flexibility to specify exactly which fields in which documents you’d like to index, all while enforcing uniqueness of that field’s value. Resulting in the unique constraint being applied only to the documents that meet the specified filter expression. 
+
+[Learn more](./feature-support-42.md)
+
+
+### Azure Cosmos DB API for MongoDB unique index reindexing (Preview)
+The unique index feature for Azure Cosmos DB allows you to create unique indexes when your collection was empty and didn't contain documents. This feature provides you with more flexibility by giving you the ability to create unique indexes whenever you want to—meaning there’s no need to plan unique indexes ahead of time before inserting any data into the collection. 
+
+[Learn more](./mongodb-indexing.md) and enable the feature today by [submitting a support ticket request](https://azure.microsoft.com/support/create-ticket/)
+
+
+### Azure Cosmos DB API for MongoDB supports version 4.2
+The Azure Cosmos DB API for MongoDB version 4.2 includes new aggregation functionality and improved security features such as client-side field encryption. These features help you accelerate development by applying the new functionality instead of developing it yourself. 
+
+[Learn more](./feature-support-42.md)
+
+
+### Support $expr in Mongo 3.6+
+`$expr` allows the use of [aggregation expressions](https://www.mongodb.com/docs/manual/meta/aggregation-quick-reference/#std-label-aggregation-expressions) within the query language. 
+`$expr` can build query expressions that compare fields from the same document in a `$match` stage.  
+
+[Learn more](https://www.mongodb.com/docs/manual/reference/operator/query/expr/)
+
+
+###  Role-Based Access Control for $merge stage
+* Added Role-Based Access Control(RBAC) for `$merge` stage. 
+* `$merge` writes the results of aggregation pipeline to specified collection. The `$merge` operator must be the last stage in the pipeline
+
+[Learn more](https://www.mongodb.com/docs/manual/reference/operator/aggregation/merge/)
+
+
+## Next steps
+
+- Learn how to [use Studio 3T](connect-using-mongochef.md) with Azure Cosmos DB API for MongoDB.
+- Learn how to [use Robo 3T](connect-using-robomongo.md) with Azure Cosmos DB API for MongoDB.
+- Explore MongoDB [samples](nodejs-console-app.md) with Azure Cosmos DB API for MongoDB.
+- Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.
+    - If all you know is the number of vCores and servers in your existing database cluster, read about [estimating request units using vCores or vCPUs](../convert-vcore-to-request-unit.md). 
+    - If you know typical request rates for your current database workload, read about [estimating request units using Azure Cosmos DB capacity planner](estimate-ru-capacity-planner.md).