Java 批量执行程序库:下载信息

Important

此库不是Azure Cosmos DB的最新Java批量执行程序。 请考虑使用 Azure Cosmos DB Java SDK v4 来执行批量操作。 若要升级,请按照 Migrate 中的说明作,Azure Cosmos DB Java SDK v4 指南和 Reactor vs RxJava 指南。

Important

2024 年 2 月 29 日,Azure Cosmos DB Sync Java SDK v2.x 已停用。 SDK 和使用 SDK 的所有应用程序(包括批量执行程序) 将继续正常运行。 Azure Cosmos DB不再为此 SDK 提供维护和支持。 建议按照上述说明迁移到 Azure Cosmos DB Java SDK v4。

链接/注释
Description 客户端应用程序可以使用批量执行程序库在Azure Cosmos DB帐户中执行批量操作。 批量执行程序库提供 BulkImport 和 BulkUpdate 命名空间。 该 BulkImport 模块可以以优化的方式批量引入文档,以便在其最大范围内使用为集合预配的吞吐量。 该BulkUpdate模块可以将Azure Cosmos DB容器中的现有数据批量更新为修补程序。
SDK 下载 Maven
GitHub 中的批量执行程序库 GitHub
API 文档 Java API 参考文档
入门 Java SDK 的批量执行程序库入门
支持的最低运行时 Java开发工具包 (JDK) 7+

发行说明

2.12.3

  • 修复包装在内IllegalStateException时的GoneException重试策略。 此更改可确保网关缓存在 410 上刷新,因此 Spark 连接器(适用于 Spark 2.4)可以使用自定义重试策略来允许查询在分区拆分期间成功。

2.12.2

  • 修复了导致文档有时无法导入暂时性错误的问题。

2.12.1

  • 升级以使用最新版本的 Azure Cosmos DB Core SDK。

2.12.0

  • 改进了通过 Spark 连接器为批量操作提供的 RU 预算的处理。 最初的一次性批量导入是使用 baseBatchSize 从 spark 连接器执行的,并且会收集上述批量导入的 RU 消耗量。 基于以上 RU 消耗计算 miniBatchSizeAdjustmentFactor,并据此调整小型批处理大小。 根据每个批处理导入的运行时间和消耗的 RU,将计算睡眠持续时间以限制每秒的 RU 消耗量,并用于在下一批导入之前暂停线程。

2.11.0

  • 修复了使用嵌套分区键时阻止批量更新的 bug。

2.10.0

  • 修复了 DocumentAnalyzer.java,以从 JSON 中正确提取嵌套的分区键值。

2.9.4

  • 在 BulkDelete 操作中添加了相应的功能,以便在发生特定的失败后重试,并向用户返回可重试的失败列表。

2.9.3

  • 更新 Azure Cosmos DB SDK 版本 2.4.7。

2.9.2

  • 修复 mergeAll 了继续和 id 分区键值,以便之后 id 的任何修补的文档属性以及分区键值添加到更新的项列表中。

2.9.1

  • 将并发的开始程度更新为 1,并为微型批处理添加调试日志。