.NET 批量执行程序库:下载信息.NET bulk executor library: Download information

适用于: SQL API

说明Description .NET 批量执行程序库允许客户端应用程序对 Azure Cosmos DB 帐户执行批量操作。The .NET bulk executor library allows client applications to perform bulk operations on Azure Cosmos DB accounts. 此库提供了 BulkImport、BulkUpdate 和 BulkDelete 命名空间。This library provides BulkImport, BulkUpdate, and BulkDelete namespaces. BulkImport 模块可以批量以优化方式引入文档,以便最大程度地使用为集合配置的吞吐量。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. BulkUpdate 模块可以作为修补程序批量更新 Azure Cosmos 容器中的现有数据。The BulkUpdate module can bulk update existing data in Azure Cosmos containers as patches. BulkDelete 模块可以批量以优化方式删除文档,以便最大程度地使用为集合配置的吞吐量。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 下载SDK download NuGetNuGet
GitHub 中的批量执行程序库Bulk executor library in GitHub GitHubGitHub
API 文档API documentation 参考文档.NET API reference documentation
入门Get started 批量执行程序库 .NET SDK 入门Get started with the bulk executor library .NET SDK
当前受支持的框架Current supported framework Azure .NET Framework 4.5.2、4.6.1 和 .NET Standard 2.0Azure .NET Framework 4.5.2, 4.6.1 and .NET Standard 2.0

备注

如果使用批量执行程序,请参阅 .NET SDK 的最新版本 3.x,其中内置了批量执行程序。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-preview2.4.1-preview

  • 修复了 BulkDelete 的响应中的 TotalElapsedTime,以正确测量包括所有重试在内的总时间。Fixed TotalElapsedTime in the response of BulkDelete to correctly measure the total time including any retries.

2.4.0-preview2.4.0-preview

  • 已将 SDK 依赖项更改为 >= 2.5.1。Changed SDK dependency to >= 2.5.1

2.3.0-preview22.3.0-preview2

  • 添加了对图形批量执行程序的支持,以在顶点和边缘上接受 ttlAdded support for graph bulk executor to accept ttl on vertices and edges

2.2.0-preview22.2.0-preview2

  • 修复了一个问题,在网关模式下运行时,该问题会在弹性缩放 Azure Cosmos DB 期间导致异常。Fixed an issue, which caused exceptions during elastic scaling of Azure Cosmos DB when running in Gateway mode. 此修补程序使其功能等效于 1.4.1 版本。This fix makes it functionally equivalent to 1.4.1 release.

2.1.0-preview22.1.0-preview2

  • 添加了对 SQL API 帐户的 BulkDelete 支持,以接受要删除的分区键、文档 ID 元组。Added BulkDelete support for SQL API accounts to accept partition key, document ID tuples to delete. 此更改使其功能等效于 1.4.0 版本。This change makes it functionally equivalent to 1.4.0 release.

2.0.0-preview22.0.0-preview2

  • 包括了 MongoBulkExecutor 来支持 .NET Standard 2.0。Including MongoBulkExecutor to support .NET Standard 2.0. 此功能使其功能等效于 1.3.0 版本,增加了支持使用 .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-preview2.0.0-preview

  • 添加了 .NET Standard 2.0 作为受支持的目标框架之一,以使批量执行程序库与 .NET Core 应用程序一起工作。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.91.8.9

  • 修复了在将包含转义引号的值作为输入参数传递时出现的 BulkDeleteAsync 问题。Fixed an issue with BulkDeleteAsync when values with escaped quotes were passed as input parameters.

1.8.81.8.8

  • 修复了一个问题,即 MongoBulkExecutor 通过添加填充意外增大了文档大小并在某些情况下超出最大文档大小限制。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.71.8.7

  • 修复了在集合具有嵌套分区键路径时出现的 BulkDeleteAsync 问题。Fixed an issue with BulkDeleteAsync when the Collection has nested partition key paths.

1.8.61.8.6

  • MongoBulkExecutor 现在实现了 IDisposable,且在使用后会被释放。MongoBulkExecutor now implements IDisposable and it's expected to be disposed after used.

1.8.51.8.5

  • 已在 SDK 版本上删除锁定。Removed lock on SDK version. 包现在依赖于 SDK >= 2.5.1。Package is now dependent on SDK >= 2.5.1.

1.8.41.8.4

  • 修复了使用具有数值的 POCO 对象列表调用 BulkImport 时标识符的处理。Fixed handling of identifiers when calling BulkImport with a list of POCO objects with numeric values.

1.8.31.8.3

  • 修复了 BulkDelete 的响应中的 TotalElapsedTime,以正确测量包括所有重试在内的总时间。Fixed TotalElapsedTime in the response of BulkDelete to correctly measure the total time including any retries.

1.8.21.8.2

  • 修复了在某些情况下 CPU 使用率过高的情况。Fixed high CPU consumption on certain scenarios.
  • 跟踪功能现在使用了 TraceSource。Tracing now uses TraceSource. 用户可以为 BulkExecutorTrace 源定义侦听器。Users can define listeners for the BulkExecutorTrace source.
  • 修复了在发送大小接近 2Mb 的文档时可能导致锁定的罕见情况。Fixed a rare scenario that could cause a lock when sending documents near 2Mb of size.

1.6.01.6.0

  • 已将批量执行程序更新为现在使用最新版本的 Azure Cosmos DB .NET SDK (2.4.0)Updated the bulk executor to now use the latest version of the Azure Cosmos DB .NET SDK (2.4.0)

1.5.01.5.0

  • 添加了对图形批量执行程序的支持,以在顶点和边缘上接受 ttlAdded support for graph bulk executor to accept ttl on vertices and edges

1.4.11.4.1

  • 修复了一个问题,在网关模式下运行时,该问题会在弹性缩放 Azure Cosmos DB 期间导致异常。Fixed an issue, which caused exceptions during elastic scaling of Azure Cosmos DB when running in Gateway mode.

1.4.01.4.0

  • 添加了对 SQL API 帐户的 BulkDelete 支持,以接受要删除的分区键、文档 ID 元组。Added BulkDelete support for SQL API accounts to accept partition key, document ID tuples to delete.

1.3.01.3.0

  • 修复了一个问题,该问题导致批量执行程序使用的用户代理出现格式设置问题。Fixed an issue, which caused a formatting issue in the user agent used by bulk executor.

1.2.01.2.0

  • 改进了批量执行程序导入和更新 API,使其在存储超出了当前容量且未引发异常时以透明方式适应 Cosmos 容器的弹性缩放。Made improvement to bulk executor import and update APIs to transparently adapt to elastic scaling of Cosmos container when storage exceeds current capacity without throwing exceptions.

1.1.21.1.2

  • 增加了对版本 2.1.3 的 DocumentDB .NET SDK 依赖项。Bumped up the DocumentDB .NET SDK dependency to version 2.1.3.

1.1.11.1.1

  • 修复了一个问题,该问题导致批量执行程序在导入到固定集合时引发 JSRT 错误。Fixed an issue, which caused bulk executor to throw JSRT error while importing to fixed collections.

1.1.01.1.0

  • 添加了对 Azure Cosmos DB SQL API 帐户的 BulkDelete 操作的支持。Added support for BulkDelete operation for Azure Cosmos DB SQL API accounts.
  • 使用 Azure Cosmos DB 的 API for MongoDB 添加了对帐户进行 BulkImport 操作的支持。Added support for BulkImport operation for accounts with Azure Cosmos DB's API for MongoDB.
  • 增加了对版本 2.0.0 的 DocumentDB .NET SDK 依赖项。Bumped up the DocumentDB .NET SDK dependency to version 2.0.0.

1.0.21.0.2

  • 添加了对 Azure Cosmos DB Gremlin API 帐户的 BulkImport 操作的支持。Added support for BulkImport operation for Azure Cosmos DB Gremlin API accounts.

1.0.11.0.1

  • 对 Azure Cosmos DB SQL API 帐户的 BulkImport 操作的小 bug 修复。Minor bug fix to the BulkImport operation for Azure Cosmos DB SQL API accounts.

1.0.01.0.0

  • 添加了对 Azure Cosmos DB SQL API 帐户的 BulkImport 和 BulkUpdate 操作的支持。Added support for BulkImport and BulkUpdate operations for Azure Cosmos DB SQL API accounts.

后续步骤Next steps

若要了解批量执行程序 Java 库,请参阅以下文章:To learn about the bulk executor Java library, see the following article:

Java 批量执行程序库 SDK 和发行信息Java bulk executor library SDK and release information