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

文章
11/08/2024

適用於：NoSQL

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

警告

此版本的 Spring Data Azure Cosmos DB SDK 取決於舊版的 Spring Boot 和 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 V3 中的效能問題和不穩定，強烈建議您針對專案使用 Azure Spring Data Azure Cosmos DB v5 。若要升級，請遵循移轉至 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 Boot 版本支援

此項目支援多個 Spring Boot 版本。如需詳細資訊，請造訪 spring boot 支持原則。 Maven 用戶可以繼承自 spring-boot-starter-parent 專案，以取得相依性管理區段，讓 Spring 管理相依性的版本。如需詳細資訊，請造訪 spring boot 版本支援。

Spring Data 版本支援

此項目支援不同的 spring-data-commons 版本。如需詳細資訊，請造訪 Spring 數據版本支援。

我應該使用哪個版本的 Azure Spring Data Azure Cosmos DB

Azure Spring Data Azure Cosmos DB 連結庫支援多個版本的 Spring Boot /Spring Cloud。如需 Azure Spring Data Azure Cosmos DB 與 Spring Boot /Spring Cloud 版本搭配使用之 Azure Spring Data Azure Cosmos DB 版本的詳細資訊，請參閱 Azure Spring Data Azure Cosmos DB 版本對應。

重要

這些版本資訊適用於第 3 版的 Spring Data Azure Cosmos DB。

Azure Spring Data Azure Cosmos DB SDK 相依於 Spring Data 架構，且僅支援 NoSQL 的 API。

請參閱下列文章，以取得與其他 Azure Cosmos DB API 上的 Spring Data 有關的資訊：

快速開始使用

遵循 Spring Boot Starter 指南，開始使用 Spring Data Azure Cosmos DB 並加以執行。 Spring Boot Starter 方法是開始使用 Spring Data Azure Cosmos DB 連接器的建議方式。

或者，您可以將 Spring Data Azure Cosmos DB 相依性新增至檔案 pom.xml ，如下所示：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-spring-data-cosmos</artifactId>
    <version>latest-version</version>
</dependency>

有用的內容

Content	連結
版本資訊	Spring Data Azure Cosmos DB SDK v3 的版本資訊
SDK 文件	Azure Spring Data Azure Cosmos DB SDK v3 檔
SDK 下載	Maven
API 文件	Java API 參考檔
參與 SDK	GitHub 上的 Azure SDK for Java Central 存放庫
開始	快速入門：建置 Spring Data Azure Cosmos DB 應用程式來管理適用於 NoSQL 數據的 Azure Cosmos DB GitHub 存放庫與快速入門程序代碼
基本程式代碼範例	Azure Cosmos DB：適用於 NoSQL 的 API 的 Spring Data Azure Cosmos DB 範例使用範例程式代碼的 GitHub 存放庫
效能祕訣	Java SDK v4 的效能秘訣（適用於 Spring Data）
疑難排解	針對 Java SDK v4 進行疑難解答（適用於 Spring Data）
Azure Cosmos DB 研討會和實驗室	Azure Cosmos DB 研討會首頁

發行版本記錄

版本歷程記錄會保留在 azure-sdk-for-java 存放庫中，如需版本的詳細清單，請參閱變更記錄檔。

建議的版本

強烈建議升級至 Azure Spring Data Azure Cosmos DB v5 ，並使用最低建議的版本和更新版本。

其他注意事項

Spring Data Azure Cosmos DB 支援 Java JDK 8、Java JDK 11。 3.8.0 版和更新版本也支援 Java JDK 17。

常見問題集

如何收到即將淘汰 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。

分享方式：