Kit SDK Java Azure Cosmos DB v4 pour l’API pour NoSQL : notes de publication et ressources

S’APPLIQUE À : NoSQL

Le Kit de développement logiciel (SDK) Java Azure Cosmos DB v4 pour NoSQL combine une API asynchrone et une API synchrone en un seul artefact Maven. Le Kit de développement logiciel (SDK) v4 offre des performances améliorées, de nouvelles fonctionnalités d’API et une prise en charge asynchrone basée sur le réacteur de projet et la bibliothèque Netty. Les utilisateurs peuvent s’attendre à des performances améliorées avec le Kit de développement logiciel (SDK) Java Azure Cosmos DB v4 par rapport au Kit de développement logiciel (SDK) Java Azure Cosmos DB v2 asynchrone et au Kit de développement logiciel (SDK) Java Azure Cosmos DB v2 synchrone.

Important

Ces notes de publication concernent uniquement le Kit de développement logiciel (SDK) Java Azure Cosmos DB v4. Si vous utilisez actuellement une version antérieure à v4, consultez le guide Migrer votre application pour utiliser le SDK Java v4 Azure Cosmos DB afin d’obtenir de l’aide sur la mise à niveau vers v4.

Voici trois étapes pour aller plus vite.

  1. Installez le Runtime Java minimal pris en charge, JDK 8, pour pouvoir utiliser le Kit de développement logiciel (SDK).
  2. Utilisez le guide de démarrage rapide pour le Kit de développement logiciel (SDK) Java Azure Cosmos DB v4, qui vous permet d’accéder à l’artefact Maven et de passer en revue les requêtes Azure Cosmos DB de base.
  3. Pour optimiser le Kit de développement logiciel (SDK) pour votre application, lisez les conseils sur les performances et sur le dépannage relatifs au Kit de développement logiciel (SDK) Java Azure Cosmos DB v4.

Les ateliers et laboratoires Azure Cosmos DB sont une autre formidable ressource pour apprendre à utiliser le Kit de développement logiciel (SDK) Java Azure Cosmos DB v4.

Contenu utile

Contenu Lien
Notes de publication Notes de publication du SDK Java v4
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 : Générer une application Java pour gérer les données d’Azure Cosmos DB for NoSQL
Référentiel GitHub avec code de démarrage rapide
Bonnes pratiques Bonnes pratiques pour le SDK Java v4
Exemples de code de base Azure Cosmos DB : exemples Java pour l’API pour NoSQL
Référentiel GitHub avec exemple de code
Application console avec flux de modification Flux de modification – Exemple de Kit de développement logiciel (SDK) Java v4
Référentiel GitHub avec exemple de code
Exemple d’application web Créer une application web avec le Kit de développement logiciel (SDK) Java v4
Référentiel GitHub avec exemple de code
Conseils sur les performances Conseils en performances pour le Kit de développement logiciel (SDK) Java v4
Dépannage Résoudre les problèmes du Kit de développement logiciel (SDK) Java v4
Migration d’un ancien Kit de développement logiciel (SDK) vers la v4 Migrer vers le Kit de développement logiciel (SDK) Java V4
Runtime minimal pris en charge JDK 8
Ateliers et laboratoires Azure Cosmos DB Page d’accueil relative aux ateliers Azure Cosmos DB

Important

  • La version 4.13.0 met à jour les versions majeures de reactor-core et reactor-netty pour le train de mise en production de 2020.0.4 (Europium).

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 4.48.2 ou ultérieure.

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

Pour en savoir plus sur Azure Cosmos DB, consultez la page du service Microsoft Azure Cosmos DB.