Vytvoření vazby databáze Azure Cosmos DB k aplikaci v Azure Spring Apps

Poznámka

Azure Spring Apps je nový název služby Azure Spring Cloud. I když má služba nový název, uvidíte na některých místech starý název, protože pracujeme na aktualizaci prostředků, jako jsou snímky obrazovek, videa a diagramy.

Tento článek se vztahuje na: ✔️ Java ❌ C #

Tento článek se vztahuje na: ✔️ Úroveň ✔️ Basic/Standard Enterprise vrstvy

Místo ruční konfigurace aplikací Spring Boot můžete automaticky svázat vybrané služby Azure s vašimi aplikacemi pomocí Azure Spring Apps. Tento článek ukazuje, jak vytvořit vazbu aplikace na databázi Azure Cosmos DB.

Požadavky:

Příprava projektu v Javě

  1. Do souboru pom.xml pom.xml vaší aplikace přidejte jednu z následujících závislostí. Zvolte závislost, která je vhodná pro váš typ rozhraní API.

    • Typ rozhraní API: Core (SQL)

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

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

      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-cassandra</artifactId>
      </dependency>
      
    • Typ rozhraní API: Tabulka Azure

      <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>azure-storage-spring-boot-starter</artifactId>
          <version>2.0.5</version>
      </dependency>
      
  2. Aktualizujte aktuální aplikaci spuštěním az spring app deploynebo vytvořte nové nasazení pro tuto změnu spuštěním az spring app deployment create.

Vytvoření vazby aplikace k Azure Cosmos DB

Azure Cosmos DB má pět různých typů rozhraní API, které podporují vazbu. Následující postup ukazuje, jak je používat:

  1. Vytvoří účet databáze Azure Cosmos DB. Nápovědu najdete v rychlém startu při vytváření databáze .

  2. Poznamenejte si název databáze. Pro účely tohoto postupu je název databáze testdb.

  3. V Azure Portal přejděte na stránku služby Azure Spring Apps. Přejděte na řídicí panel aplikace a vyberte aplikaci, která se má svázat s Azure Cosmos DB. Tato aplikace je stejná, jakou jste aktualizovali nebo nasadili v předchozím kroku.

  4. Vyberte vazbu služby a vyberte Vytvořit vazbu služby. Pokud chcete vyplnit formulář, vyberte:

    • Hodnota typu vazbyAzure Cosmos DB.
    • Typ rozhraní API.
    • Název databáze.
    • Účet Azure Cosmos DB.

    Poznámka

    Pokud používáte Cassandra, použijte pro název databáze mezeru klíče.

  5. Restartujte aplikaci výběrem možnosti Restartovat na stránce aplikace.

  6. Pokud chcete zajistit, aby byla služba správně svázaná, vyberte název vazby a ověřte jeho podrobnosti. Pole property by mělo být podobné tomuto příkladu:

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

Další kroky

V tomto článku jste zjistili, jak vytvořit vazbu aplikace v Azure Spring Apps na databázi Azure Cosmos DB. Další informace o vazbách služeb k aplikaci najdete v tématu Vytvoření vazby k Azure Cache for Redis mezipaměti.