適用於 NoSQL 之 API 的 Spring Data Azure Cosmos DB v2 （舊版）：版本資訊和資源

  • 發行項

適用於： NoSQL

適用於 NoSQL 的 Spring Data Azure Cosmos DB 第 2 版可讓開發人員在 Spring 應用程式中使用 Azure Cosmos DB。 Spring Data Azure Cosmos DB 會公開 Spring Data 介面，以操作資料庫和集合、處理檔，以及發出查詢。 相同的 Maven 成品同時支援同步處理和異步 （回應式） API。

警告

此版本的 Spring Data Azure Cosmos DB SDK 取決於已淘汰的 Azure Cosmos DB Java SDK 版本。 這個 Spring Data Azure Cosmos DB SDK 將於近期宣佈為即將淘汰！ 這不是適用於 Azure Cosmos DB 的最新 Azure Spring Data Azure Cosmos DB SDK，而且已過期。 由於 Azure Spring Data Azure Cosmos DB SDK V2 中的效能問題和不穩定，強烈建議您針對專案使用 Azure Spring Data Azure Cosmos DB v3 。 若要升級，請遵循移轉至 Azure Cosmos DB Java SDK v4 指南中的指示，了解基礎 Java SDK V4 的差異。

Spring Framework 是一種程式設計與設定模型，可簡化 Java 應用程式開發。 Spring 使用相依性插入來簡化應用程式的「管線」。 許多開發人員，例如 Spring，因為它會讓建置和測試應用程式更為直接。 Spring Boot 會利用 Web 應用程式和微服務開發來擴充管流處理。 Spring Data 是一種程式設計模型，可從 Spring 或 Spring Boot 應用程式的內容存取 Azure Cosmos DB 等數據存放區。

您可以在裝載於 Azure Spring Apps 的應用程式中使用 Spring Data Azure Cosmos DB。

重要

這些版本資訊適用於 Spring Data Azure Cosmos DB 第 2 版。 您可以在這裡找到第 3 版的版本資訊。

Spring Data Azure Cosmos DB 僅支援 NoSQL 的 API。

如需其他 Azure Cosmos DB API 上的 Spring Data 相關信息，請參閱下列文章：

想要快速上手嗎？

  1. 安裝最低支援的 Java 執行時間 JDK 8，讓您可以使用 SDK。
  2. 使用 入門來建立 Spring Data Azure Cosmos DB 應用程式。 很容易！
  3. 請完成 Spring Data Azure Cosmos DB 開發人員指南，逐步解說基本的 Azure Cosmos DB 要求。

您可以使用 Spring Initializr 快速啟動 Spring Boot Starter 應用程式！

資源

資源 連結
SDK 下載 Maven
API 文件 Spring Data Azure Cosmos DB 參考檔
參與 SDK GitHub 上的 Spring Data Azure Cosmos DB 存放庫
Spring Boot Starter 適用於 Java 的 Azure Cosmos DB Spring Boot Starter 用戶端連結庫
開發人員指南 Spring Data Azure Cosmos DB 開發人員指南
使用入門 如何搭配適用於 NoSQL 的 Azure Cosmos DB 使用 Spring Boot Starter
適用於 Azure Cosmos DB Spring Boot Starter 的 GitHub 存放庫
使用 Azure App 服務 的範例 如何使用 Spring 和 Azure Cosmos DB 搭配 Linux 上的 App Service

發行版本記錄

2.3.0 （2020 年 5 月 21 日）

新功能

  • 更新 Spring Boot 版本至 2.3.0。

2.2.5 （2020 年 5 月 19 日）

新功能

  • 更新 Azure Cosmos DB 3.7.3 版。

重要錯誤修正

  • 包含來自 Azure Cosmos DB SDK 3.7.3 的記憶體流失修正和 Netty 版本升級。

2.2.4 （2020 年 4 月 6 日）

重要錯誤修正

  • 修正 allowTelemetry 要 CosmosDbConfig從 中考慮的旗標。
  • 修正 TTL 容器上的屬性。

2.2.3 （2020 年 2 月 25 日）

新功能

  • findAll依分割區索引鍵 API 新增 。
  • 更新 Azure Cosmos DB 3.7.0 版。

重要錯誤修正

  • 修正 collectionName ->containerName.
  • 修正 entityClass 和 domainClass ->domainType。
  • 修正「傳回儲存機制所儲存的實體集合，而不是輸入實體」。

2.1.10 （2020 年 2 月 25 日）

重要錯誤修正

  • Backports 修正「傳回儲存機制所儲存的實體集合，而不是輸入實體」。

2.2.2 （2020 年 1 月 15 日）

新功能

  • 更新 Azure Cosmos DB 3.6.0 版。

重要錯誤修正

2.2.1 （2019 年 12 月 31 日）

新功能

  • 更新 Azure Cosmos DB SDK 3.5.0 版。
  • 新增註釋欄位，以啟用或停用自動收集建立。
  • 改善例外狀況處理。 CosmosClientException透過CosmosDBAccessException公開 。
  • requestCharge公開與 activityId 透過 ResponseDiagnostics。

重要錯誤修正

  • SDK 3.5.0 更新修正「Azure Cosmos DB HTTP 回應標頭大於 8192 位元節時例外狀況」，“Bounded Staleness 和一致前置詞上的 ConsistencyPolicy.defaultConsistencyLevel（） 失敗。
  • 修正 findById 方法的行為。 先前，如果找不到實體，這個方法會傳回空白，而不是擲回例外狀況。
  • 修正在使用時 CosmosPageRequest ，下一頁未套用排序的錯誤。

2.1.9 （2019 年 12 月 26 日）

新功能

  • 新增註釋欄位，以啟用或停用自動收集建立。

重要錯誤修正

  • 修正 findById 方法的行為。 先前，如果找不到實體，這個方法會傳回空白，而不是擲回例外狀況。

2.2.0 （2019 年 10 月 21 日）

新功能

  • 完成回應式 Azure Cosmos DB 存放庫支援。
  • Azure Cosmos DB 要求診斷字串和查詢計量支援。
  • Azure Cosmos DB SDK 版本更新為 3.3.1。
  • Spring Framework 版本升級至 5.2.0.RELEASE。
  • Spring Data Commons 版本升級至 2.2.0.RELEASE。
  • 新增 findByIdAndPartitionKey 和 deleteByIdAndPartitionKey API。
  • 從 azure-documentdb 移除相依性。
  • 將 DocumentDB 重新命名為 Azure Cosmos DB。

重要錯誤修正

  • 修正「當 pageSize 小於存放庫中項目總數時，排序會擲回例外狀況」。

2.1.8 （2019 年 10 月 18 日）

新功能

  • 取代 DocumentDB API。
  • 新增 findByIdAndPartitionKey 和 deleteByIdAndPartitionKey API。
  • 根據 _etag新增開放式鎖定。
  • 啟用檔案集合名稱的 SpEL 運算式。
  • 新增 ObjectMapper 改良功能。

2.1.7 （2019 年 10 月 18 日）

新功能

  • 新增 Azure Cosmos DB SDK 第 3 版相依性。
  • 新增回應式 Azure Cosmos DB 存放庫。
  • DocumentDbTemplate 更新 實作，以使用 Azure Cosmos DB SDK 第 3 版。
  • 新增回應式 Azure Cosmos DB 存放庫支援的其他設定變更。

2.1.2 （2019 年 3 月 19 日）

重要錯誤修正

  • applicationInsights移除的相依性：
    • 相依性污染的潛在風險。
    • Java 11 不相容。
    • 避免對 CPU 和/或記憶體的潛在效能影響。

2.0.7 （2019 年 3 月 20 日）

重要錯誤修正

  • Backport 會 applicationInsights 移除的相依性：
    • 相依性污染的潛在風險。
    • Java 11 不相容。
    • 避免對 CPU 和/或記憶體的潛在效能影響。

2.1.1 （2019 年 3 月 7 日）

新功能

  • 更新 主要版本設為 2.1.1。

2.0.6 （2019 年 3 月 7 日）

新功能

  • 忽略遙測的所有例外狀況。

2.1.0 （2018 年 12 月 17 日）

新功能

  • 更新 2.1.0 版以解決問題。

2.0.5 （2018 年 9 月 13 日）

新功能

  • 新增關鍵字 exists 與 startsWith。
  • 更新 自述檔。

重要錯誤修正

  • 修正「無法直接呼叫 Entity 的自我參考」。
  • 修正「如果未建立集合，findAll 將會失敗」。

2.0.4 （發行前版本） （2018 年 8 月 23 日）

新功能

  • 將套件從 documentdb 重新命名為 cosmosdb。
  • 新增查詢方法關鍵詞的新功能。 現在支援來自 NoSQL API 的 16 個關鍵詞。
  • 新增具有分頁和排序的查詢新功能。
  • 簡化 spring-data-cosmosdb 的設定。
  • 新增 deleteCollection 和 deleteAll API。

重要錯誤修正

  • 錯誤修正和瑕疵風險降低。

常見問題集

如何收到即將淘汰 SDK 的通知？

Microsoft 會在淘汰 SDK 終止支援之前提供 12 個月的提前通知，以利順利轉換至支援的 SDK。 我們會透過各種通道通知您：Azure 入口網站、Azure 更新，以及直接通訊給指派的服務系統管理員。

我可以在 12 個月期間使用即將淘汰的 Azure Cosmos DB SDK 來撰寫應用程式嗎？

是，您可以在 12 個月的通知期間使用即將淘汰的 Azure Cosmos DB SDK 來撰寫、部署和修改應用程式。 建議您在 12 個月的通知期間，視需要移轉至較新的 Azure Cosmos DB SDK 版本。

淘汰日期之後，使用不支援的 Azure Cosmos DB SDK 的應用程式會發生什麼事？

淘汰日期之後，Azure Cosmos DB 將不再進行錯誤修正、新增功能，或為已淘汰的 SDK 版本提供支援。 如果您不想升級，從已淘汰版本的 SDK 傳送要求將繼續由 Azure Cosmos DB 服務提供服務。

哪些 SDK 版本會有最新的功能和更新？

新功能和更新只會新增至最新支援的主要 SDK 版本的最新次要版本。 建議您一律使用最新版本來利用新功能、效能改善和錯誤修正。 如果您使用舊版、未淘汰的 SDK，對 Azure Cosmos DB 的要求仍會正常運作，但您無法存取任何新功能。

如果我無法在截止日期之前更新應用程式，該怎麼辦？

建議您儘早升級至最新的 SDK。 將 SDK 標記為淘汰之後，您將有 12 個月的時間更新您的應用程式。 如果您無法從淘汰日期更新，從已淘汰版本的 SDK 傳送要求將繼續由 Azure Cosmos DB 提供服務，因此執行中的應用程式將繼續運作。 但 Azure Cosmos DB 將不再對已淘汰的 SDK 版本進行錯誤修正、新增功能或提供支援。

如果您有支援方案並需要技術支援， 請提出支援票證以與我們連絡 。

如何要求功能新增至 SDK 或連接器？

新功能不一定會立即新增至每個 SDK 或連接器。 如果不支援您想要新增的功能，請將意見反應新增至我們的 社群論壇。

下一步

深入瞭解 Azure Cosmos DB。

深入瞭解 Spring Framework。

深入瞭解 Spring Boot。

深入瞭解 Spring Data。