Partager via


Connecter une base de données Azure Cosmos DB à votre application dans Azure Spring Apps

Remarque

Les plans Essentiel, Standardet Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce concernant la mise hors service d’Azure Spring Apps.

La consommation Standard et le plan dédié seront déconseillés à compter du 30 septembre 2024, avec un arrêt complet six mois après. Nous vous recommandons de passer à Azure Container Apps. Pour découvrir plus d’informations, consultez Migrer la consommation Standard et le plan dédié Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à : ✔️ Java ✔️ C#

Cet article s’applique au : Niveau ✔️ De base/Standard ✔️ Entreprise

Au lieu de configurer manuellement vos applications Spring Boot, vous pouvez connecter automatiquement les services Azure sélectionnés à vos applications à l’aide d’Azure Spring Apps. Cet article explique comment connecter votre application à une base de données Azure Cosmos DB.

Prérequis

Préparation du projet

  1. Ajoutez l’une des dépendances suivantes dans le fichier pom.xml de votre application. Choisissez la dépendance qui convient à votre type d’API.

    • Type d’API : NoSQL

      <dependency>
          <groupId>com.azure.spring</groupId>
          <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
      </dependency>
      
    • Type d’API : MongoDB

      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-mongodb</artifactId>
      </dependency>
      
    • Type d’API : Cassandra

      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-cassandra</artifactId>
      </dependency>
      
  2. Mettez à jour l’application actuelle en exécutant az spring app deploy ou créez un déploiement pour ce changement en exécutant az spring app deployment create.

Connecter votre application à la base de données Azure Cosmos DB

Remarque

Par défaut, les connecteurs de service sont créés au niveau de l’application. Pour remplacer les connexions, vous pouvez créer à nouveau d’autres connexions dans les déploiements.

Utilisation de l’interface de ligne de commande Microsoft Azure

Utilisez Azure CLI pour configurer votre application Spring afin qu’elle se connecte à une base de données Cosmos NoSQL à l’aide de la commande az spring connection create, comme illustré dans l’exemple suivant. Veillez à remplacer les variables de l’exemple par vos valeurs.

Remarque

La mise à jour des paramètres de base de données Azure Cosmos DB peut prendre quelques minutes.

Remarque

Si vous utilisez Cosmos Cassandra, utilisez --key_space au lieu de --database. Si vous utilisez Cosmos Table, utilisez --table au lieu de --database. Pour plus d’informations, consultez Démarrage rapide : Créer une connexion de service dans Azure Spring Apps avec Azure CLI.

az spring connection create cosmos-sql \
    --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
    --app $APP_NAME \
    --target-resource-group $COSMOSDB_RESOURCE_GROUP \
    --account $COSMOSDB_ACCOUNT_NAME \
    --database $DATABASE_NAME \
    --secret

Remarque

Si vous utilisez Service Connector pour la première fois, commencez par exécuter la commande az provider register --namespace Microsoft.ServiceLinker pour inscrire le fournisseur de ressources Service Connector.

Conseil

Exécutez la commande az spring connection list-support-types --output table pour obtenir la liste des méthodes d’authentification et services cibles pris en charge pour Azure Spring Apps. Si la commande az spring n’est pas reconnue par le système, vérifiez que vous avez installé l’extension requise en exécutant az extension add --name spring.

Utilisation du portail Azure

Vous pouvez également utiliser le portail Azure pour configurer cette connexion en effectuant les étapes suivantes. Le Portail Microsoft Azure fournit les mêmes fonctionnalités qu’Azure CLI, et offre une expérience interactive.

  1. Sélectionnez votre instance d’applications Azure Spring Apps dans le Portail Microsoft Azure et sélectionnez Applications dans le menu de navigation. Choisissez l’application que vous souhaitez connecter et sélectionnez Service Connector dans le menu de navigation.

  2. Sélectionnez Créer.

  3. Sous l’onglet Informations de base, pour type de service, sélectionnez Cosmos DB, puis choisissez un abonnement. Pour Type d’API, sélectionnez Core (SQL), choisissez un compte Cosmos DB et une base de données. Pour type de client, sélectionnez Java, puis Suivant : Authentification. Si vous n’avez pas encore créé votre base de données, consultez Démarrage rapide : Créer un compte, une base de données, un conteneur et des éléments Azure Cosmos DB à partir du Portail Azure.

  4. Sous l’onglet Authentification, choisissez Chaîne de connexion. Service Connector récupère automatiquement la clé d’accès à partir de votre compte Cosmos DB. Sélectionnez Suivant : Réseau.

  5. Sous l’onglet Réseau, sélectionnez Configurer les règles de pare-feu pour activer l’accès au service cible, puis Vérifier + créer.

  6. Sous l’onglet Vérifier + créer, attendez la validation, puis sélectionnez Créer. La création peut prendre quelques minutes.

  7. Une fois la connexion entre vos applications Spring et votre base de données Cosmos DB générée, vous pouvez la voir dans la page Connecteur de services et sélectionner le bouton de développement pour afficher les variables de connexion configurées.

Étapes suivantes

Dans cet article, vous avez vu comment connecter votre application dans Azure Spring Apps à une base de données Azure Cosmos DB. Pour en savoir plus sur la connexion de services à votre application, consultez Se connecter à un cache Azure Cache pour Redis.