NoSQL 用 API 向けの Spring Data Azure Cosmos DB v5 のリリース ノートとリソース

NoSQL 用 Spring Data Azure Cosmos DB バージョン 5 により、開発者は Spring アプリケーションで Azure Cosmos DB を使用できます。 Spring Data Azure Cosmos DB では、データベースとコレクションの操作、ドキュメントの操作、クエリの発行を行うための Spring Data インターフェイスが公開されています。 同期 API と非同期 (リアクティブ) API の両方とも、同じ Maven 成果物でサポートされています。

Spring Framework は、Java アプリケーション開発を効率化するプログラミングおよび構成モデルです。 Spring では依存関係の挿入を使用して、アプリケーションの "プラミング" が効率化されます。 アプリケーションの構築とテストが簡潔になるため、多くの開発者が Spring を好んでいます。 Spring Boot は、Web アプリとマイクロサービスの開発を目的として、このプラミングの処理を拡張したものです。 Spring Data は、Spring または Spring Boot アプリケーションのコンテキストから Azure Cosmos DB などのデータストアにアクセスするためのプログラミング モデルおよびフレームワークです。

Spring Data Azure Cosmos DB は、Azure Spring Apps でホストされているアプリケーションで使用できます。

バージョンのサポート ポリシー

Spring Boot バージョンのサポート

このプロジェクトでは、複数の Spring Boot バージョンがサポートされています。 詳細については、Spring Boot のサポート ポリシーを参照してください。 Maven ユーザーは、spring-boot-starter-parent プロジェクトを継承して、依存関係管理セクションを取得し、Spring で依存関係のためにバージョンを管理できるようにします。 詳細については、「Spring Boot バージョンのサポート」を参照してください。

Spring Data バージョンのサポート

このプロジェクトでは、さまざまな spring-data-commons のバージョンがサポートされています。 詳細については、「Spring Data バージョンのサポート」を参照してください。

どのバージョンの Azure Spring Data Azure Cosmos DB を使用すべきか

Azure Spring Data Azure Cosmos DB ライブラリでは、Spring Boot/Spring Cloud の複数のバージョンがサポートされています。 Spring Boot/Spring Cloud バージョンで使用する Azure Spring Data Azure Cosmos DB のバージョンの詳細についてはAzure Spring Data Azure Cosmos DB のバージョン マッピングに関するページを参照してください。

すぐに開始

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>

役に立つコンテンツ

リリース履歴

リリース履歴は azure-sdk-for-java リポジトリで管理されています。リリースの詳細なリストについては、changelog ファイルを参照してください。

推奨されるバージョン

バージョン 5.18.0 以降を使用することを強くお勧めします。

その他のメモ

• Spring Data Azure Cosmos DB v5 は、Java JDK 17 以降のみをサポートします。

FAQ

SDK の提供終了はどのような方法で通知されますか?

Microsoftは、サポート対象の SDK へのスムーズな移行を容易にするために、廃止された SDK のサポートが終了する前に 12 か月前に通知します。 Azure ポータル、Azureの更新、割り当てられたサービス管理者への直接の通信など、さまざまな通信チャネルを通じて通知されます。

12 か月の期間中に、to-be-retired Azure Cosmos DB SDK を使用してアプリケーションを作成できますか

はい。12 か月の通知期間中に、to-be-retired 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 の詳細を確認してください。