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

適用対象: NoSQL

• .NET SDK v3
• .NET SDK v2
• .NET Core SDK v2
• .NET Change Feed SDK v2
• Node.js
• Java SDK v4
• Sync Java SDK v2
• Async Java SDK v2
• Spring Data v2
• Spring Data v3
• Spring Data v5
• Python
• Go
• REST
• REST リソース プロバイダー
• SQL
• Bulk Executor - .NET v2
• Bulk Executor - Java

NoSQL 用 Spring Data Azure Cosmos DB バージョン 3 により、開発者は 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 Data Azure Cosmos DB のバージョン 3 に関するものです。

Azure Spring Data Cosmos DB SDK は Spring Data フレームワークに依存しており、NoSQL 用 API のみをサポートしています。

他の Azure Cosmos DB API での Spring Data については、次の記事を参照してください。

• Azure Cosmos DB での Apache Cassandra 用 Spring Data
• Azure Cosmos DB での Spring Data MongoDB

すぐに開始

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>

役に立つコンテンツ

コンテンツ	Link
リリース ノート	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 中央リポジトリ
開始するには	クイックスタート: Spring Data Azure Cosmos DB アプリを構築して Azure Cosmos DB for NoSQL データを管理する クイック スタート コードを含む 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 リポジトリで管理されています。リリースの詳細なリストについては、changelog ファイルを参照してください。

推奨されるバージョン

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

追加メモ

• Spring Data Azure Cosmos DB では、Java JDK 8、Java JDK 11、およびバージョン 3.8.0 以降の Java JDK 17 がサポートされています。

よく寄せられる質問

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

サポートされる SDK に速やかに移行できるように、提供終了となる SDK のサポート終了は 12 か月前に通知されます。 さらに、Azure portal、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 の詳細を確認してください。