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,并为微型批处理添加调试日志。