Partage via


Spring Data Azure Cosmos DB v3 for API for NoSQL : Notes de publication et ressources

S’APPLIQUE À : NoSQL

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.

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. Pour obtenir des informations détaillées sur la version d’Azure Spring Data Azure Cosmos DB à utiliser avec chaque version de Spring Boot / Spring Cloud, consultez Mappage des versions d’Azure Spring Data Azure Cosmos DB.

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

Contenu Lien
Notes de publication Notes de publication du SDK Spring Data Azure Cosmos DB v3
Documentation du SDK Documentation du SDK Azure Spring Data Azure Cosmos DB v3
Téléchargement du Kit de développement logiciel (SDK) Maven
Documentation de l’API Documentation de référence sur l’API Java
Contribution au Kit de développement logiciel (SDK) Référentiel centralisé relatif au Kit de développement logiciel (SDK) Azure pour Java sur GitHub
Prise en main Démarrage rapide : Créer une application Spring Data Azure Cosmos DB pour gérer des données Azure Cosmos DB for NoSQL
Référentiel GitHub avec code de démarrage rapide
Exemples de code de base Azure Cosmos DB : Exemples Spring Data Azure Cosmos DB pour l’API pour NoSQL
Référentiel GitHub avec exemple de code
Conseils sur les performances Conseils de performances pour le kit de développement logiciel (SDK) Java v4 (applicables à Spring Data)
Dépannage Résoudre les problèmes liés au kit de développement logiciel (SDK) Java V4 (applicable à Spring Data)
Ateliers et laboratoires Azure Cosmos DB Page d’accueil relative aux ateliers Azure Cosmos DB

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.

Il est fortement recommandé d’utiliser la version 3.28.1 et ultérieure.

Remarques supplémentaires

  • Spring Data Azure Cosmos DB prend en charge Java JDK 8, Java JDK 11 et versions 3.8.0 et ultérieures 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.