Привязывание базы данных Azure Cosmos DB к приложению Azure Spring CloudBind an Azure Cosmos DB database to your Azure Spring Cloud application

Чтобы не настраивать приложения Spring Boot вручную, вы можете автоматически привязать выбранные службы Azure к приложениям с помощью Azure Spring Cloud.Instead of manually configuring your Spring Boot applications, you can automatically bind select Azure services to your applications by using Azure Spring Cloud. В этой статье показано, как привязать приложение к базе данных Azure Cosmos DB.This article demonstrates how to bind your application to an Azure Cosmos DB database.

Предварительные требования:Prerequisites:

Привязка Azure Cosmos DBBind Azure Cosmos DB

Azure Cosmos DB имеет пять различных типов API, поддерживающих привязку.Azure Cosmos DB has five different API types that support binding. В приведенной ниже процедуре показано, как их использовать:The following procedure shows how to use them:

  1. Создает базу данных Azure Cosmos DB.Create an Azure Cosmos DB database. Дополнительные сведения см. в статье Краткое руководство. Создание учетной записи, базы данных, контейнера и элементов Azure Cosmos на портале Azure.Refer to the quickstart on creating a database for help.

  2. Запишите имя базы данных.Record the name of your database. Для этой процедуры имя базы данных — testdb.For this procedure, the database name is testdb.

  3. Добавьте одну из указанных ниже зависимостей в файл pom.xml приложения Azure Spring Cloud.Add one of the following dependencies to your Azure Spring Cloud application's pom.xml file. Выберите зависимость, соответствующую вашему типу API.Choose the dependency that is appropriate for your API type.

    • Тип API: Core (SQL)API type: Core (SQL)

      <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>azure-cosmosdb-spring-boot-starter</artifactId>
          <version>2.1.6</version>
      </dependency>
      
    • Тип API: MongoDBAPI type: MongoDB

      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-mongodb</artifactId>
      </dependency>
      
    • Тип API: CassandraAPI type: Cassandra

      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-data-cassandra</artifactId>
      </dependency>
      
    • Тип API: Gremlin (граф)API type: Gremlin (graph)

      <dependency>
          <groupId>com.microsoft.spring.data.gremlin</groupId>
          <artifactId>spring-data-gremlin</artifactId>
          <version>2.1.7</version>
      </dependency>
      
    • Тип API: таблице AzureAPI type: Azure Table

      <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>azure-storage-spring-boot-starter</artifactId>
          <version>2.0.5</version>
      </dependency>
      
  4. Выполните команду az spring-cloud app update, чтобы обновить текущее развертывание, или команду az spring-cloud app deployment create, чтобы его создать.Use az spring-cloud app update to update the current deployment, or use az spring-cloud app deployment create to create a new deployment. Эти команды либо обновляют, либо создают приложение с новой зависимостью.These commands will either update or create the application with the new dependency.

  5. Перейдите к странице своей службы Azure Spring Cloud на портале Azure.Go to your Azure Spring Cloud service page in the Azure portal. Перейдите на панель мониторинга приложения и выберите приложение для привязки к Azure Cosmos DB.Go to Application Dashboard and select the application to bind to Azure Cosmos DB. Это то же приложение, которое вы обновили или развернули на предыдущем шаге.This application is the same one you updated or deployed in the previous step.

  6. Выберите Service binding (Привязка службы), а затем — Создание привязки службы.Select Service binding, and select Create service binding. Чтобы заполнить форму, выберите:To fill out the form, select:

    • для типа привязки значение Azure Cosmos DB;The Binding type value Azure Cosmos DB.
    • тип API;The API type.
    • имя базы данных;Your database name.
    • учетную запись Azure Cosmos DB.The Azure Cosmos DB account.

    Примечание

    Если используется Cassandra, укажите пространство ключей для имени базы данных.If you are using Cassandra, use a key space for the database name.

  7. Перезапустите приложение, нажав кнопку Перезапустить на странице приложения.Restart the application by selecting Restart on the application page.

  8. Чтобы обеспечить правильную привязку службы, выберите имя привязки и проверьте сведения о ней.To ensure the service is bound correctly, select the binding name and verify its details. Поле property должно выглядеть приблизительно как в приведенном примере:The property field should be similar to this example:

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

Дальнейшие действияNext steps

В этом учебнике описывается, как привязать приложение Azure Spring Cloud к базе данных Azure Cosmos DB.In this tutorial, you learned how to bind your Azure Spring Cloud application to an Azure Cosmos DB database. Чтобы узнать, как привязать приложение к Кэшу Azure для Redis, перейдите к следующему учебнику.To learn how to bind your application to an Azure Cache for Redis cache, continue to the next tutorial.