Merge pull request #230513 from TimShererWithAquent/us2036619k

Freshness Pass User Story: 2036619 Azure Cosmos DB bulk executor library overview

Author: v-emilypr

articles/cosmos-db/bulk-executor-overview.md

@@ -5,50 +5,56 @@ author: abinav2307
 ms.service: cosmos-db
 ms.custom: ignite-2022
 ms.topic: overview
-ms.date: 05/28/2019
+ms.date: 3/30/2023
 ms.author: abramees
 ms.reviewer: mjbrown
 ---
 
 # Azure Cosmos DB bulk executor library overview
 [!INCLUDE[NoSQL](includes/appliesto-nosql.md)]
- 
-Azure Cosmos DB is a fast, flexible, and globally distributed database service that is designed to elastically scale out to support: 
 
-* Large read and write throughput (millions of operations per second).  
-* Storing high volumes of (hundreds of terabytes, or even more) transactional and operational data with predictable millisecond latency.  
+Azure Cosmos DB is a fast, flexible, and globally distributed database service that elastically scales out to support:
 
-The bulk executor library helps you leverage this massive throughput and storage. The bulk executor library allows you to perform bulk operations in Azure Cosmos DB through bulk import and bulk update APIs. You can read more about the features of bulk executor library in the following sections. 
+* Large read and write throughput, on the order of millions of operations per second.  
+* Storing high volumes of transactional and operational data, on the order of hundreds of terabytes or even more, with predictable millisecond latency.  
 
-> [!NOTE] 
-> Currently, bulk executor library supports import and update operations and this library is supported by Azure Cosmos DB API for NoSQL and Gremlin accounts only.
+The bulk executor library helps you use this massive throughput and storage. The bulk executor library allows you to perform bulk operations in Azure Cosmos DB through bulk import and bulk update APIs. You can read more about the features of bulk executor library in the following sections.
+
+> [!NOTE]
+> Currently, bulk executor library supports import and update operations. Azure Cosmos DB API supports this library for NoSQL and Gremlin accounts only.
 
 > [!IMPORTANT]
-> The bulk executor library is not currently supported on [serverless](serverless.md) accounts. On .NET, it is recommended to use the [bulk support](https://devblogs.microsoft.com/cosmosdb/introducing-bulk-support-in-the-net-sdk/) available in the V3 version of the SDK.
- 
+> The bulk executor library is not currently supported on [serverless](serverless.md) accounts. On .NET, we recommend that you use the [bulk support](https://devblogs.microsoft.com/cosmosdb/introducing-bulk-support-in-the-net-sdk/) available in the V3 version of the SDK.
+
 ## Key features of the bulk executor library  
- 
-* It significantly reduces the client-side compute resources needed to saturate the throughput allocated to a container. A single threaded application that writes data using the bulk import API achieves 10 times greater write throughput when compared to a multi-threaded application that writes data in parallel while saturating the client machine's CPU.  
 
-* It abstracts away the tedious tasks of writing application logic to handle rate limiting of request, request timeouts, and other transient exceptions by efficiently handling them within the library.  
+* Using the bulk executor library significantly reduces the client-side compute resources needed to saturate the throughput allocated to a container. A single threaded application that writes data using the bulk import API achieves 10 times greater write throughput when compared to a multi-threaded application that writes data in parallel while it saturates the client machine's CPU.  
+
+* The bulk executor library abstracts away the tedious tasks of writing application logic to handle rate limiting of request, request timeouts, and other transient exceptions. It efficiently handles them within the library.  
+
+* It provides a simplified mechanism for applications to perform bulk operations to scale out. A single bulk executor instance that runs on an Azure virtual machine can consume greater than 500 K RU/s. You can achieve a higher throughput rate by adding more instances on individual client virtual machines.  
+
+* The bulk executor library can bulk import more than a terabyte of data within an hour by using a scale-out architecture.  
+
+* It can bulk update existing data in Azure Cosmos DB containers as patches.
+
+## How does the bulk executor operate?
+
+When a bulk operation to import or update documents is triggered with a batch of entities, they're initially shuffled into buckets that correspond to their Azure Cosmos DB partition key range. Within each bucket that corresponds to a partition key range, they're broken down into mini-batches.
+
+Each mini-batch acts as a payload that is committed on the server-side. The bulk executor library has built in optimizations for concurrent execution of the mini-batches both within and across partition key ranges.
 
-* It provides a simplified mechanism for applications performing bulk operations to scale out. A single bulk executor instance running on an Azure VM can consume greater than 500K RU/s and you can achieve a higher throughput rate by adding additional instances on individual client VMs.  
- 
-* It can bulk import more than a terabyte of data within an hour by using a scale-out architecture.  
+The following diagram illustrates how bulk executor batches data into different partition keys:  
 
-* It can bulk update existing data in Azure Cosmos DB containers as patches. 
- 
-## How does the bulk executor operate? 
+:::image type="content" source="./media/bulk-executor-overview/bulk-executor-architecture.png" alt-text="Diagram shows bulk executor architecture.":::
 
-When a bulk operation to import or update documents is triggered with a batch of entities, they are initially shuffled into buckets corresponding to their Azure Cosmos DB partition key range. Within each bucket that corresponds to a partition key range, they are broken down into mini-batches and each mini-batch act as a payload that is committed on the server-side. The bulk executor library has built in optimizations for concurrent execution of these mini-batches both within and across partition key ranges. Following image illustrates how bulk executor batches data into different partition keys:  
+The bulk executor library makes sure to maximally utilize the throughput allocated to a collection. It uses an [AIMD-style congestion control mechanism](https://tools.ietf.org/html/rfc5681) for each Azure Cosmos DB partition key range to efficiently handle rate limiting and timeouts.
 
-:::image type="content" source="./media/bulk-executor-overview/bulk-executor-architecture.png" alt-text="Bulk executor architecture" :::
+For more information about sample applications that consume the bulk executor library, see [Use the bulk executor .NET library to perform bulk operations in Azure Cosmos DB](nosql/bulk-executor-dotnet.md) and [Perform bulk operations on Azure Cosmos DB data](bulk-executor-java.md).
 
-The bulk executor library makes sure to maximally utilize the throughput allocated to a collection. It uses an [AIMD-style congestion control mechanism](https://tools.ietf.org/html/rfc5681) for each Azure Cosmos DB partition key range to efficiently handle rate limiting and timeouts. 
+For reference information, see [.NET bulk executor library](nosql/sdk-dotnet-bulk-executor-v2.md) and [Java bulk executor library](nosql/sdk-java-bulk-executor-v2.md).
 
-## Next Steps 
+## Next steps
 
-* Learn more by trying out the sample applications consuming the bulk executor library in [.NET](nosql/bulk-executor-dotnet.md) and [Java](bulk-executor-java.md).  
-* Check out the bulk executor SDK information and release notes in [.NET](nosql/sdk-dotnet-bulk-executor-v2.md) and [Java](nosql/sdk-java-bulk-executor-v2.md).
-* The bulk executor library is integrated into the Azure Cosmos DB Spark connector, to learn more, see [Azure Cosmos DB Spark connector](./nosql/quickstart-spark.md) article.  
-* The bulk executor library is also integrated into a new version of [Azure Cosmos DB connector](../data-factory/connector-azure-cosmos-db.md) for Azure Data Factory to copy data.
+* [Azure Cosmos DB Spark connector](./nosql/quickstart-spark.md)
+* [Azure Cosmos DB connector](../data-factory/connector-azure-cosmos-db.md)