Spring Data Azure Cosmos DB v3 pour l’API pour NoSQL (hérité) : notes de publication et ressources
S’APPLIQUE À : 
NoSQL
- Kit de développement logiciel (SDK) .NET v3
- SDK .NET v2
- SDK .NET Core v2
- SDK .NET Change Feed v2
- Node.JS
- Kit SDK Java v4
- SDK Java Sync v2
- Kit SDK Java asynchrone v2
- Spring Data v2
- Spring Data v3
- Spring Data v5
- Python
- Go
- REST
- API REST Resource Provider
- SQL
- Exécuteur en bloc – .NET v2
- Exécuteur en bloc – Java
La version 3 de Spring Data Azure Cosmos DB for NoSQL permet aux développeurs d’utiliser Azure Cosmos DB dans des applications Spring. Spring Data Azure Cosmos DB expose l’interface de données Spring pour manipuler les bases de données et les collections, travailler avec des documents et émettre des requêtes. Les API synchrones et asynchrones (réactives) sont prises en charge dans le même artefact Maven.
Avertissement
Cette version du Kit de développement logiciel (SDK) Spring Data Azure Cosmos DB dépend d’une version antérieure de Spring Boot et du Kit de développement logiciel (SDK) Java Azure Cosmos DB. La mise hors service de ce SDK Spring Data Cosmos DB sera bientôt annoncée ! Il ne s’agit pas de la dernière version du SDK Azure Spring Data Cosmos DB pour Azure Cosmos DB. Cette version est obsolète. En raison de problèmes de performances et d’instabilité dans le Kit de développement logiciel (SDK) Azure Spring Data Azure Cosmos DB V3, nous vous recommandons vivement d’utiliser Azure Spring Data Azure Cosmos DB v5 pour votre projet. Pour effectuer la mise à niveau, suivez les instructions du guide Migrer vers le kit SDK Java v4 Azure Cosmos DB pour comprendre la différence du kit Java v4 sous-jacent.
Spring Framework est un modèle de programmation et de configuration qui rationalise le développement d’applications Java. Spring rationalise la « plomberie » des applications en injectant des dépendances. De nombreux développeurs apprécient Spring, car il rend la création et le test d’applications plus simples. Spring Boot étend cette prise en charge de la plomberie en vue du développement d’applications web et de microservices. Spring Data est un modèle de programmation et une infrastructure permettant l’accès à des magasins de données tels qu’Azure Cosmos DB à partir du contexte d’une application Spring ou Spring Boot.
Vous pouvez utiliser Spring Data Azure Cosmos DB dans vos applications hébergées dans Azure Spring Apps.
Politique de support des versions
Prise en charge des versions de Spring Boot
Ce projet prend en charge plusieurs versions de Spring Boot. Pour plus d’informations, consultez la politique de prise en charge de Spring Boot. Les utilisateurs de Maven peuvent hériter du projet spring-boot-starter-parent pour obtenir une section de gestion des dépendances afin de permettre à Spring de gérer les versions des dépendances. Pour plus d’informations, consultez la prise en charge des versions de Spring Boot.
Prise en charge des versions de Spring Data
Ce projet prend en charge différentes versions courantes de Spring Data. Pour plus d’informations, consultez la prise en charge des versions de Spring Data.
Quelle version d’Azure Spring Data pour Azure Cosmos DB utiliser ?
La bibliothèque Azure Spring Data Azure Cosmos DB prend en charge plusieurs versions de Spring Boot / Spring Cloud. Reportez-vous au mappage de version Azure Spring Data Azure Cosmos DB pour obtenir des informations détaillées sur la version d’Azure Spring Data Azure Cosmos DB à utiliser avec Spring Boot /Spring Cloud version.
Important
Ces notes de publication sont destinées à la version 3 de Spring Data Azure Cosmos DB.
Le SDK Azure Spring Data Azure Cosmos DB dépend du framework Spring Data et prend en charge seulement l’API pour NoSQL.
Pour plus d’informations concernant Spring Data sur d’autres API d’Azure Cosmos DB, consultez les articles suivants :
Démarrer rapidement
Familiarisez-vous avec Spring Data Azure Cosmos DB en suivant le Guide de Spring Boot Starter. L'approche Spring Boot Starter est la méthode recommandée pour commencer à utiliser le connecteur Spring Data Azure Cosmos DB.
Vous pouvez également ajouter la dépendance Spring Data Azure Cosmos DB à votre fichier pom.xml, comme indiqué ci-dessous :
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-spring-data-cosmos</artifactId>
<version>latest-version</version>
</dependency>
Contenu utile
Historique des mises en production
L’historique des versions est conservé dans le référentiel azure-sdk-for-java. Pour obtenir une liste détaillée des versions, consultez le fichier d’historique des versions.
Version recommandée
Il est vivement recommandé de procéder à une mise à niveau vers Azure Spring Data Azure Cosmos DB v5 et d’utiliser la version minimale recommandée et les versions ultérieures.
Remarques supplémentaires
- Spring Data Azure Cosmos DB prend en charge Java JDK 8, Java JDK 11. La version 3.8.0 et ultérieure prend également en charge Java JDK 17.
Questions fréquentes (FAQ)
Comment serai-je informé du retrait du kit SDK ?
Microsoft vous avertit 12 mois à l’avance de la fin de la prise en charge d’un kit SDK mis hors service afin de favoriser une transition en douceur vers un kit SDK pris en charge. Nous vous informons via différents canaux de communication : le portail Azure, les mises à jour Azure et une communication directe avec les administrateurs de service affectés.
Pendant cette période de 12 mois, puis-je créer des applications à l’aide d’un kit SDK Azure Cosmos DB destiné à être mis hors service ?
Oui, au cours de la période de préavis de 12 mois, vous pouvez créer, déployer et modifier des applications à l’aide du kit SDK Azure Cosmos DB destiné à être mis hors service. Nous vous conseillons de migrer vers une version prise en charge plus récente du kit SDK Azure Cosmos DB pendant cette période de 12 mois, le cas échéant.
Après la date de mise hors service, qu’advient-il des applications qui utilisent le kit SDK Azure Cosmos DB non pris en charge ?
Après la date de mise hors service, Azure Cosmos DB n’apporte plus de correctifs de bogues, n’ajoute plus de nouvelles fonctionnalités et ne fournit plus de support aux versions mises hors service du kit SDK. Si vous préférez ne pas effectuer la mise à niveau, les requêtes envoyées depuis les versions mises hors service du Kit de développement logiciel (SDK) continueront d’être traitées par le service Azure Cosmos DB.
Quelles versions du kit SDK disposent des dernières fonctionnalités et mises à jour ?
Les nouvelles fonctionnalités et mises à jour ne sont ajoutées qu’à la dernière version mineure de la dernière version majeure prise en charge du kit SDK. Nous vous recommandons de toujours utiliser la dernière version pour tirer parti des nouvelles fonctionnalités, des améliorations des performances et des correctifs de bogues. Si vous utilisez une ancienne version du kit SDK encore en service, vos requêtes vers Azure Cosmos DB continuent de fonctionner, mais vous n’avez accès à aucune des nouvelles fonctionnalités.
Que faire si je ne parviens pas à mettre à jour mon application avant la date limite ?
Nous vous recommandons de mettre à niveau vers la dernière version du kit de développement logiciel dès que possible. Une fois qu’un kit SDK est marqué pour la mise hors service, vous avez 12 mois pour mettre à jour votre application. Si vous n’êtes pas en mesure de procéder à une mise à jour avant la date de mise hors service, les requêtes envoyées à partir des versions mises hors service du kit SDK continuent d’être traitées par Azure Cosmos DB. Vos applications continuent donc de fonctionner. Toutefois, Azure Cosmos DB n’apporte plus de correctifs de bogues, n’ajoute plus de nouvelles fonctionnalités et ne fournit plus de support aux versions mises hors service du kit SDK.
Si vous disposez d’un plan de support et avez besoin d’assistance technique, veuillez nous contacter en remplissant un ticket de support.
Comment puis-je demander l’ajout de fonctionnalités à un SDK ou un connecteur ?
Les nouvelles fonctionnalités ne sont pas toujours ajoutées à chaque SDK ou connecteur immédiatement. S’il existe une fonctionnalité non prise en charge que vous souhaitez ajouter, ajoutez des commentaires à notre forum communautaire.
Étapes suivantes
Apprenez-en davantage sur Azure Cosmos DB.
Apprenez-en davantage sur Spring Framework.
Apprenez-en davantage sur Spring Boot.
Apprenez-en davantage sur Spring Data.