适用于 NoSQL 的 Spring Data Azure Cosmos DB v5 for API：发行说明和资源

Aplica-se a: ✅ NoSQL

适用于 NoSQL 的 Spring Data Azure Cosmos DB 版本 5 允许开发人员在 Spring 应用程序中使用Azure Cosmos DB。 Spring Data Azure Cosmos DB公开 Spring Data 接口，用于操作数据库和集合、处理文档和发出查询。同一 Maven 项目中同时支持 Sync 和 Async (Reactive) API。

Spring Framework 是一种编程和配置模型，可简化Java应用程序开发。 Spring 使用依赖项注入来简化应用程序的“管道”。由于 Spring 使得生成和测试应用程序变得更加简单，因此许多开发人员都喜欢 Spring。 Spring Boot 重视 Web 应用程序和微服务的开发，扩展了这种管道处理。 Spring Data是一种编程模型和框架，用于从 Spring 或 Spring Boot 应用程序的上下文访问数据存储（如Azure Cosmos DB）。

版本支持策略

Spring Boot 版本支持

此项目支持多个 Spring Boot 版本。有关详细信息，请访问 pring 启动支持策略。 Maven 用户可从 spring-boot-starter-parent 项目继承来获取依赖项管理部分，使 Spring 能够管理依赖项的版本。有关详细信息，请访问 pring 启动版本支持。

Spring Data 版本支持

此项目支持不同的 spring-data-commons 版本。有关详细信息，请访问 pring 数据版本支持。

我应使用哪个版本的 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 版本。

重要

这些发行说明适用于 Spring Data Azure Cosmos DB版本 5。

Azure Spring Data Azure Cosmos DB SDK 依赖于 Spring Data 框架，并且仅支持用于NoSQL的 API。

快速入门

按照 Pring 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	Link
发行说明	Spring Data Azure Cosmos DB SDK v5
SDK 文档	Azure Spring Data Azure Cosmos DB SDK v5 文档
SDK 下载	Maven
API 文档	Java API 参考文档
参与 SDK	GitHubAzure SDK>
入门	使用快速入门代码GitHub存储库
基本代码示例	包含示例代码的 GitHub 存储库
性能提示	适用于 Java SDK v4（适用于 Spring Data）性能提示>
故障排除	Troubleshoot Java SDK v4（适用于 Spring Data）
Azure Cosmos DB研讨会和实验室	Azure Cosmos DB研讨会主页

发行历史

azure-sdk-for-java 存储库中维护发布历史记录，有关发布的详细列表，请参阅 changelog 文件。

建议的版本

强烈建议使用 5.18.0 及更高版本。

其他注释

Spring Data Azure Cosmos DB v5 仅支持 Java JDK 17 及更高版本。

FAQ

如何收到即将停用的 SDK 的通知？

Azure将在停用 SDK 的支持结束前提供 12 个月的提前通知，以便顺利过渡到受支持的 SDK。我们将通过各种通信渠道通知你：Azure门户、Azure更新，以及直接与分配的服务管理员通信。

12 个月期间使用 to-be停用的 Azure Cosmos DB SDK 创作应用程序？

是的，你将能够在 12 个月的通知期内使用 to-be停用的 Azure Cosmos DB SDK 创作、部署和修改应用程序。建议在 12 个月的通知期内迁移到较新的受支持版本的 Azure Cosmos DB SDK，视情况而定。

停用日期后，使用不支持的 Azure Cosmos DB SDK 的应用程序会发生什么情况？

停用日期后，Azure Cosmos DB将不再进行 bug 修复、添加新功能或为停用的 SDK 版本提供支持。如果不想升级，则从已停用版本的 SDK 发送的请求将继续由Azure Cosmos DB服务提供服务。

哪些 SDK 版本将包含最新功能和更新？

新功能和更新将仅添加到最新的受支持的主要 SDK 版本的最新次要版本。建议始终使用最新版本，以充分利用新功能、性能改进和 bug 修补程序。如果使用的是旧版非停用版本的 SDK，则对Azure Cosmos DB的请求仍然有效，但你无权访问任何新功能。

如果无法在截止日期之前更新应用程序，该怎么办？

我们建议尽早升级到最新 SDK。 SDK 标记为要停用之后，你将有 12 个月的时间来更新应用程序。如果无法按停用日期更新，则从已停用版本的 SDK 发送的请求将继续由Azure Cosmos DB提供服务，因此正在运行的应用程序将继续正常运行。但是，Azure Cosmos DB将不再进行 bug 修复、添加新功能或为停用的 SDK 版本提供支持。

如果你有支持计划并需要技术支持，请创建支持工单以联系我们。

如何请求将功能添加到 SDK 或连接器？

新功能并不总是立即添加到每个 SDK 或连接器中。如果你想添加的功能不受支持，请在我们的社区论坛提出反馈。

后续步骤

详细了解 Azure Cosmos DB。

了解有关 Spring Framework 的详细信息。

详细了解有关 Spring Boot 的详细信息。

详细了解有关 Spring Data 的详细信息。

Last updated on 2026-04-10

Compartilhar via