Een Azure Cosmos DB-database verbinden met uw toepassing in Azure Spring Cloud

Dit artikel is van toepassing op: ✔️ Java

In plaats van uw Spring Boot-toepassingen handmatig te configureren, kunt u de geselecteerde Azure-services automatisch met uw toepassingen verbinden met behulp van Azure Spring Cloud. In dit artikel wordt beschreven hoe u uw toepassing verbindt met een Azure Cosmos DB-database.

Vereisten:

Uw Java-project voorbereiden

  1. Voeg een van de volgende afhankelijkheden toe aan het pom.xml pom.xml van uw toepassing. Kies de afhankelijkheid die geschikt is voor uw type API.

    • Type API: Core (SQL)

      <dependency>
          <groupId>com.azure.spring</groupId>
          <artifactId>azure-spring-boot-starter-cosmos</artifactId>
          <version>3.6.0</version>
      </dependency>
      
    • Type API: MongoDB

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

      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-cassandra</artifactId>
      </dependency>
      
    • Type API: Azure Table

      <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>azure-storage-spring-boot-starter</artifactId>
          <version>2.0.5</version>
      </dependency>
      
  2. Werk de huidige app bij door uit az spring-cloud app deploy te werken of maak een nieuwe implementatie voor deze wijziging door uit te az spring-cloud app deployment create gaan.

Uw app verbinden met de Azure Cosmos DB

Azure Cosmos DB heeft vijf verschillende typen API's die ondersteuning bieden voor binding. De volgende procedure laat zien hoe u deze gebruikt:

  1. Hiermee maakt u een Azure Cosmos DB-database. Raadpleeg de quickstart over het maken van een database voor hulp.

  2. Noteer de naam van uw database. Voor deze procedure is de databasenaam testdb.

  3. Ga naar de pagina van Azure Spring Cloud in de Azure-portal. Ga naar Toepassingsdashboard en selecteer de toepassing die u met Azure Cosmos DB wilt verbinden. Dit is dezelfde toepassing als die u in de vorige stap hebt bijgewerkt of geïmplementeerd.

  4. Selecteer Servicebinding en selecteer de knop Servicebinding maken. Selecteer het volgende om het formulier in te vullen:

    • Voor het Bindingstype de waarde Azure Cosmos DB.
    • Het type API.
    • De naam van uw database.
    • Het Azure Cosmos DB-account.

    Notitie

    Als u Cassandra gebruikt, gebruikt u een sleutelruimte voor de naam van de database.

  5. Start de toepassing opnieuw door Opnieuw opstarten te selecteren op de toepassingspagina.

  6. Om er zeker van te zijn dat de service correct is verbonden, selecteert u de naam van de binding en controleert u de gegevens. Het veld property moet er ongeveer als volgt uitzien:

    azure.cosmosdb.uri=https://<some account>.documents.azure.com:443
    azure.cosmosdb.key=abc******
    azure.cosmosdb.database=testdb
    

Volgende stappen

In dit artikel hebt u geleerd hoe u uw toepassing in uw Azure Spring Cloud aan een Azure Cosmos DB database. Zie Verbinden met een Azure Cache voor Redis-cache voor meer informatie over bindingsservices voor uw toepassing.