Edit

.NET bulk executor library: Download information (Legacy)

  • Article

APPLIES TO: NoSQL

Link/notes
Description The .NET bulk executor library allows client applications to perform bulk operations on Azure Cosmos DB accounts. This library provides BulkImport, BulkUpdate, and BulkDelete namespaces. The BulkImport module can bulk ingest documents in an optimized way such that the throughput provisioned for a collection is consumed to its maximum extent. The BulkUpdate module can bulk update existing data in Azure Cosmos DB containers as patches. The BulkDelete module can bulk delete documents in an optimized way such that the throughput provisioned for a collection is consumed to its maximum extent.
SDK download NuGet
Bulk executor library in GitHub GitHub
API documentation .NET API reference documentation
Get started Get started with the bulk executor library .NET SDK
Current supported framework Microsoft .NET Framework 4.5.2, 4.6.1 and .NET Standard 2.0

Note

If you are using bulk executor, please see the latest version 3.x of the .NET SDK, which has bulk executor built into the SDK.

Release notes

2.4.1-preview

  • Fixed TotalElapsedTime in the response of BulkDelete to correctly measure the total time including any retries.

2.4.0-preview

  • Changed SDK dependency to >= 2.5.1

2.3.0-preview2

  • Added support for graph bulk executor to accept ttl on vertices and edges

2.2.0-preview2

  • Fixed an issue, which caused exceptions during elastic scaling of Azure Cosmos DB when running in Gateway mode. This fix makes it functionally equivalent to 1.4.1 release.

2.1.0-preview2

  • Added BulkDelete support for API for NoSQL accounts to accept partition key, document ID tuples to delete. This change makes it functionally equivalent to 1.4.0 release.

2.0.0-preview2

  • Including MongoBulkExecutor to support .NET Standard 2.0. This feature makes it functionally equivalent to 1.3.0 release, with the addition of supporting .NET Standard 2.0 as the target framework.

2.0.0-preview

  • Added .NET Standard 2.0 as one of the supported target frameworks to make the bulk executor library work with .NET Core applications.

1.8.9

  • Fixed an issue with BulkDeleteAsync when values with escaped quotes were passed as input parameters.

1.8.8

  • Fixed an issue on MongoBulkExecutor that was increasing the document size unexpectedly by adding padding and in some cases, going over the maximum document size limit.

1.8.7

  • Fixed an issue with BulkDeleteAsync when the Collection has nested partition key paths.

1.8.6

  • MongoBulkExecutor now implements IDisposable and it's expected to be disposed after used.

1.8.5

  • Removed lock on SDK version. Package is now dependent on SDK >= 2.5.1.

1.8.4

  • Fixed handling of identifiers when calling BulkImport with a list of POCO objects with numeric values.

1.8.3

  • Fixed TotalElapsedTime in the response of BulkDelete to correctly measure the total time including any retries.

1.8.2

  • Fixed high CPU consumption on certain scenarios.
  • Tracing now uses TraceSource. Users can define listeners for the BulkExecutorTrace source.
  • Fixed a rare scenario that could cause a lock when sending documents near 2Mb of size.

1.6.0

  • Updated the bulk executor to now use the latest version of the Azure Cosmos DB .NET SDK (2.4.0)

1.5.0

  • Added support for graph bulk executor to accept ttl on vertices and edges

1.4.1

  • Fixed an issue, which caused exceptions during elastic scaling of Azure Cosmos DB when running in Gateway mode.

1.4.0

  • Added BulkDelete support for API for NoSQL accounts to accept partition key, document ID tuples to delete.

1.3.0

  • Fixed an issue, which caused a formatting issue in the user agent used by bulk executor.

1.2.0

  • Made improvement to bulk executor import and update APIs to transparently adapt to elastic scaling of Azure Cosmos DB container when storage exceeds current capacity without throwing exceptions.

1.1.2

  • Bumped up the DocumentDB .NET SDK dependency to version 2.1.3.

1.1.1

  • Fixed an issue, which caused bulk executor to throw JSRT error while importing to fixed collections.

1.1.0

  • Added support for BulkDelete operation for Azure Cosmos DB for NoSQL accounts.
  • Added support for BulkImport operation for accounts with Azure Cosmos DB's API for MongoDB.
  • Bumped up the DocumentDB .NET SDK dependency to version 2.0.0.

1.0.2

  • Added support for BulkImport operation for Azure Cosmos DB for Gremlin accounts.

1.0.1

  • Minor bug fix to the BulkImport operation for Azure Cosmos DB for NoSQL accounts.

1.0.0

  • Added support for BulkImport and BulkUpdate operations for Azure Cosmos DB for NoSQL accounts.

Next steps

To learn about the bulk executor Java library, see the following article:

Java bulk executor library SDK and release information