适用于 Core (SQL) API 的 Spring Data Azure Cosmos DB v3:发行说明和资源

适用于: SQL API

开发人员可以通过适用于 Core (SQL) 的 Spring Data Azure Cosmos DB 版本 3 在 Spring 应用程序中使用 Azure Cosmos DB。 Spring Data Azure Cosmos DB 公开 Spring Data 接口,以便操作数据库和集合、使用文档和发出查询。 同一 Maven 项目中同时支持 Sync 和 Async (Reactive) API。

重要

Spring Data Azure Cosmos DB 依赖于 Spring Data 框架。

版本 3.0.0 到 3.4.0 的 azure-spring-data-cosmos 支持 Spring Data 版本 2.2 和 2.3。

版本 3.5.0 及更高版本的 azure-spring-data-cosmos 支持 Spring Data 版本 2.4.3 及更高版本。

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

可在 Azure Spring Cloud 应用程序中使用 Spring Data Azure Cosmos DB。

重要

这些发行说明适用于 Spring Data Azure Cosmos DB 的版本 3。 可以在此处找到版本 2 的发行说明

Spring Data Azure Cosmos DB 仅支持 SQL API。

请参阅以下文章,了解其他 Azure Cosmos DB API 上的 Spring Data:

快速入门

按照 Spring Boot 入门指南来启动并运行 Spring Data Azure Cosmos DB。 建议使用 Spring Boot 入门方法来开始使用 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 链接
SDK 下载 Maven
API 文档 Java API 参考文档
参与 SDK GitHub 上用于 Java 的 Azure SDK 中央存储库
入门 快速入门:构建一个 Spring Data Azure Cosmos DB 应用以管理 Azure Cosmos DB SQL API 数据
具有快速入门代码的 GitHub 存储库
基本代码示例 Azure Cosmos DB:适用于 SQL API 的 Spring Data Azure Cosmos DB 示例
具有示例代码的 GitHub 存储库
性能提示 Java SDK v4 的性能提示(适用于 Spring Data)
故障排除 Java SDK v4 疑难解答(适用于 Spring Data)
Azure Cosmos DB 研讨会和实验室 Cosmos DB 研讨会主页

重要

  • 3.10.0 版本 - 强烈建议使用 3.10.0 及更高版本。
  • 3.5.0 版本支持 Spring Boot 2.4.3 及更高版本。

版本历史记录

版本历史记录保存在 azure-sdk-for-java 存储库中,有关版本的详细列表,请参阅 changelog 文件

附加说明

  • Spring Data Azure Cosmos DB 支持 Java JDK 8 和 Java JDK 11。
  • 当前支持 Spring Data 2.3,当前不支持 Spring Data 2.4。

常见问题解答

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

Azure 会在即将停用的 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 将不再进行 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 版本提供支持。

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

后续步骤

了解有关 Azure Cosmos DB 的详细信息。

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

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

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