Important
這個函式庫並不是 Azure Cosmos DB 最新的 Java Bulk Executor。 請考慮使用 Azure Cosmos DB Java SDK v4 來執行大量作業。 若要升級,請遵循遷移至 Azure Cosmos DB Java SDK v4 指南和 Reactor vs RxJava 指南中的指示。
Important
於 2024 年 2 月 29 日,Azure Cosmos DB Sync Java SDK v2.x 正式退役。 SDK 以及所有使用 SDK 的應用程式(包括 Bulk Executor) 都能持續運作。 Azure Cosmos DB 不再提供此 SDK 的維護與支援。 我們建議依照上述指示移轉至 Azure Cosmos DB Java SDK v4。
| 連結/附注 | |
|---|---|
| Description | 用戶端應用程式可以使用 bulk executor 函式庫在 Azure Cosmos DB 帳戶中執行大量操作。 大量執行程式庫提供 BulkImport 與 BulkUpdate 命名空間。 此 BulkImport 模組可以以最佳化方式批量匯入文件,使您為集合配置的吞吐量被最大化消耗。 此BulkUpdate模組可批量更新 Azure Cosmos DB 容器中的現有資料,作為修補程式。 |
| SDK 下載 | Maven |
| GitHub 中的 Bulk Executor 函式庫 | 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 耗用量。 miniBatchSizeAdjustmentFactor 是根據上述 RU 耗用量來計算,並根據此調整迷你批次大小。 根據每次批次匯入所經過的時間與消耗的 RU,會計算一個休眠時間以限制每秒 RU 消耗,並用來在下一次批次匯入前暫停執行緒。
2.11.0
- 修正使用巢狀分割區金鑰時無法進行大量更新的錯誤。
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,並為 minibatch 新增除錯日誌。