適用於 NoSQL 的 Spring Data Azure Cosmos DB v5:版本資訊和資源

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

Spring Framework 是一種程式設計與設定模型,可簡化 Java 應用程式開發。 Spring 使用相依性插入來簡化應用程式的「管線」。 許多開發人員,例如 Spring,因為它會讓建置和測試應用程式更為直接。 Spring Boot 將這種管線處理延伸至網頁應用程式與微服務開發。 Spring Data 是一個程式設計模型與框架,用於從 Spring 或 Spring Boot 應用程式的情境中存取像 Azure Cosmos DB 這樣的資料儲存庫。

您可以在裝載於 Azure Spring 應用程式 的應用程式中使用 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 版本對應。

Important

這些發行備註適用於第 5 版的 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 v5 發行說明
SDK 文件 Azure Spring Data Azure Cosmos DB SDK v5 documentation
SDK 下載 Maven
API 文件 Java API 參考文件
貢獻至 SDK GitHub 上的 Azure SDK for Java Central Repo
開始使用 GitHub 倉庫與 quickstart 程式碼
基本程式碼範例 GitHub 倉庫及範例程式碼
效能提示 Java SDK v4(適用於 Spring Data)的效能提示
Troubleshooting 針對 Java SDK v4(適用於 Spring Data )進行疑難排解
Azure Cosmos DB 工作坊與實驗室 Azure Cosmos DB workshops 主頁

發行歷史

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

強烈建議使用5.18.0版和更新版本。

其他注意事項

  • Spring Data Azure Cosmos DB v5 僅支援 Java JDK 17 和更新版本。

FAQ

我將如何收到 SDK 退役的通知?

Microsoft 會在即將停用的 SDK 支援結束前提前 12 個月通知,協助您順利轉換至支援的 SDK。 您會透過以下通訊管道收到通知:Azure 入口網站、Azure 更新,以及直接與指定服務管理員的通訊。

我可以在 12 個月期間使用已停用的 to-beAzure Cosmos DB SDK 來撰寫應用程式嗎?

是的,您可以在 12 個月通知期內使用 to-be-retired Azure Cosmos DB SDK 來撰寫、部署及修改應用程式。 我們建議您在 12 個月通知期內,視情況遷移至支援更新的 Azure Cosmos DB SDK 版本。

在退休日期過後,使用不受支援的 Azure Cosmos DB SDK 的應用程式會發生什麼事?

在退役日期過後,Azure Cosmos DB 將不再提供錯誤修正、新增功能,或支援已停用的 SDK 版本。 如果您選擇不升級,Azure Cosmos DB 仍會繼續處理來自已停用版本 SDK 的請求。

哪些 SDK 版本會具備最新功能與更新?

新功能與更新僅會新增至最新支援的主要 SDK 版本的最新版本或次要版本。 建議您一律使用最新版本來利用新功能、效能改善和錯誤修正。 如果您使用的是舊版且未停用的 SDK,您對 Azure Cosmos DB 的請求仍然有效,但無法使用任何新功能。

如果我無法在截止日期前更新申請,該怎麼辦?

建議您儘早升級至最新的 SDK。 SDK 被標記為退休後,您有 12 個月的時間來更新您的應用程式。 如果您無法在退休日期前更新,Azure Cosmos DB 仍會繼續處理從已停用版本 SDK 發送的請求,讓您正在執行的應用程式能繼續運作。 但 Azure Cosmos DB 已不再修復錯誤、新增功能,或支援已停用的 SDK 版本。

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

我該如何要求將功能新增至 SDK 或連接器?

新功能並不一定會立即加入到每個 SDK 或連接器上。 如果有某項功能未被支援但你希望新增,歡迎在我們的 社群論壇留下意見。

下一步

深入瞭解 Azure Cosmos DB。

深入瞭解 Spring Framework。

深入瞭解 Spring Boot。

深入瞭解 Spring Data。