Использование Spring Data с Azure Cosmos DB в Apache Cassandra

В этой статье показано, как использовать Spring Data с Azure Cosmos DB для Apache Cassandra для создания примера приложения Java, которое хранит и извлекает данные.

Необходимые условия

• Подписка Azure— создать ее бесплатно.

• пакет средств разработки Java (JDK)версии 8 или более поздней.

• Apache Maven.

• Azure CLI.

• Клиент Git .

• cURL или аналогичную программу HTTP для тестирования функциональных возможностей.

Создание учетной записи Azure Cosmos DB

Следующая процедура создает и настраивает учетную запись Azure Cosmos DB на портале Azure.

Создание учетной записи Azure Cosmos DB с помощью портала Azure

Заметка

Дополнительные сведения о создании учетных записей см. в документации по Azure Cosmos DB.

1. Перейдите на портал Azure на https://portal.azure.com/ и войдите.

2. Выберите "Создать ресурс", нажмите кнопку "Начать работу" и выберите Azure Cosmos DB.

3. На экране Выбор API выберите Cassandra.

   

4. Укажите следующие сведения:

   • подписка: Укажите подписку Azure, которую вы хотите использовать.
   • Группа ресурсов. Укажите, следует ли создать новую группу ресурсов или выбрать существующую группу ресурсов.
   • Имя учетной записи: выберите уникальное имя для учетной записи Azure Cosmos DB. Это имя используется для создания полного доменного имени, например wingtiptoyscassandra.documents.azure.com.
   • API: укажите Cassandra для этого руководства.
   • расположение: Определите ближайший географический регион для вашей базы данных.

   

5. При вводе всех предыдущих сведений нажмите кнопку "Проверить и создать".

6. Если все выглядит правильно на странице проверки, нажмите кнопку "Создать".

Развертывание базы данных занимает несколько минут.

Добавьте пространство ключей к учетной записи Azure Cosmos DB

1. Перейдите на портал Azure на https://portal.azure.com/ и войдите.

2. Выберите все ресурсы и выберите созданную учетную запись Azure Cosmos DB.

3. Выберите Data Explorer, щелкните стрелку вниз и выберите новое пространство ключей. Введите уникальный идентификатор пространства ключей и нажмите кнопку "ОК".

   

   

Получение параметров подключения для учетной записи Azure Cosmos DB

1. Перейдите на портал Azure на https://portal.azure.com/ и войдите.

2. Выберите все ресурсы и выберите созданную учетную запись Azure Cosmos DB.

3. Выберите строки подключения и скопируйте значения полей "Точка контакта", "Порт", "Имя пользователя" и "Основной пароль ". Эти значения используются для настройки приложения позже.

   

Настройка примера приложения

Следующая процедура настраивает тестовое приложение.

1. Откройте командную оболочку и клонируйте пример проекта с помощью команды Git, как показано в следующем примере:

   git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure.git
   

2. Найдите файл application.properties в каталоге ресурсов примера проекта или создайте файл, если он еще не существует.

3. Откройте файл application.properties в текстовом редакторе и добавьте или настройте следующие строки в файле и замените примеры значения соответствующими значениями из предыдущих версий:

   spring.data.cassandra.contact-points=wingtiptoyscassandra.cassandra.cosmos.azure.com
   spring.data.cassandra.port=10350
   spring.data.cassandra.username=wingtiptoyscassandra
   spring.data.cassandra.password=********
   

   Где:

   Параметр	Описание
   spring.data.cassandra.contact-points	Указывает точку контакта, описанную ранее в этой статье.
   spring.data.cassandra.port	Указывает на порт , упомянутый ранее в этой статье.
   spring.data.cassandra.username	Указывает имя пользователя, упомянутое ранее в этой статье.
   spring.data.cassandra.password	Укажите ваш основной пароль, указанный ранее в этой статье.

4. Сохраните и закройте файл application.properties.

Упаковка и проверка примера приложения

Перейдите в каталог, содержащий файл pom.xml для сборки и тестирования приложения.

1. Создание примера приложения с помощью Maven; Например:

   mvn clean package
   

2. Запустите пример приложения; Например:

   java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar
   

3. Создайте новые записи с помощью curl командной строки. В следующих примерах показано, как создавать записи:

   curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   
   curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets
   

   Приложение должно возвращать такие значения, как в следующем примере:

   Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.
   
   Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.
   

4. Извлеките все существующие записи с помощью curl командной строки. В следующих примерах показано, как получить записи:

   curl -s http://localhost:8080/pets
   

   Приложение должно возвращать такие значения, как в следующих примерах:

   [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]
   

Сводка

В этом руководстве вы создали пример приложения Java, использующего Spring Data для хранения и извлечения информации с помощью Azure Cosmos DB для Apache Cassandra.

Очистка ресурсов

Если ресурсы больше не нужны, используйте портал Azure для их удаления. Удаление ресурсов помогает избежать непредвиденных расходов.

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

Чтобы узнать больше о Spring и Azure, перейдите в центр документации Spring в Azure.

Весна на Azure

См. также

Для получения дополнительной информации об использовании Azure с Java смотрите Azure для разработчиков Java и Работу с Azure DevOps и Java.