Spring Data Azure Cosmos DB v3 for API for NoSQL (レガシ): リリース ノートとリソース
適用対象: 
NoSQL
NoSQL 用 Spring Data Azure Cosmos DB バージョン 3 により、開発者は Spring アプリケーションで Azure Cosmos DB を使用できます。 Spring Data Azure Cosmos DB では、データベースとコレクションの操作、ドキュメントの操作、クエリの発行を行うための Spring Data インターフェイスが公開されています。 同期 API と非同期 (リアクティブ) API の両方とも、同じ Maven 成果物でサポートされています。
警告
このバージョンの Spring Data Azure Cosmos DB SDK は、古いバージョンの Spring Boot と Azure Cosmos DB Java SDK に依存しています。 この Spring Data Azure Cosmos DB SDK は、近い将来廃止が発表される予定です。 これは Azure Cosmos DB 用の最新の Azure Spring Data Azure Cosmos DB SDK "ではなく"、古くなっています。 Azure Spring Data Azure Cosmos DB SDK V3 のパフォーマンスの問題と不安定性のため、プロジェクトに Azure Spring Data Azure Cosmos DB v5 を使用することを強くお勧めします。 アップグレードするには、Azure Cosmos DB Java SDK v4 への移行に関するガイドの手順に従って、基になる Java SDK V4 での違いについて理解してください。
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 については、次の記事を参照してください。
すぐに開始
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 ファイルを参照してください。
推奨されるバージョン
Azure Spring Data Azure Cosmos DB v5 にアップグレードしminimum 推奨バージョン以降を使用することを強くお勧めします。
追加メモ
- 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 の詳細を確認してください。