Como usar o Spring Data com o Azure Cosmos DB para Apache Cassandra

Este artigo mostra como usar Spring Data com Azure Cosmos DB para Apache Cassandra para criar uma aplicação Java de exemplo que armazena e recupera dados.

Pré-requisitos

• Uma assinatura do Azure - crie uma gratuitamente.

• Java Development Kit (JDK), versão 8 ou superior.

• Apache Maven.

• CLI do Azure.

• Um cliente Git.

• cURL ou um utilitário HTTP semelhante para testar a funcionalidade.

Criar uma conta do Azure Cosmos DB

O procedimento a seguir cria e configura uma conta do Azure Cosmos DB no portal do Azure.

Crie uma conta Azure Cosmos DB usando o portal Azure

1. Navegue até o portal do Azure em https://portal.azure.com/ e entre.

2. Selecione Criar um recurso, selecione Começar, e depois selecione Azure Cosmos DB.

3. Na opção Selecionar API no ecrã, selecione Cassandra.

   

4. Especifique as seguintes informações:

   • Subscrição: especifique a sua subscrição do Azure a utilizar.
   • Grupo de recursos: Especifique se deve criar um novo grupo de recursos ou escolher um grupo de recursos existente.
   • Nome da conta: Escolha um nome único para a sua conta Azure Cosmos DB. Este nome é usado para criar um domínio totalmente qualificado como wingtiptoyscassandra.documents.azure.com.
   • API: Especifique Cassandra para este tutorial.
   • Localização: Especifique a região geográfica mais próxima para o seu banco de dados.

   

5. Quando introduzir toda a informação anterior, selecione Rever + criar.

6. Se tudo parecer correto na página de avaliação, selecione Criar.

Leva alguns minutos para implantar o banco de dados.

Adicionar um espaço de chave à sua conta do Azure Cosmos DB

1. Navegue até o portal do Azure em https://portal.azure.com/ e entre.

2. Seleciona Todos os Recursos e depois seleciona a conta Azure Cosmos DB que criaste.

3. Selecione Data Explorer, selecione a seta para baixo e selecione Novo espaço de chaves. Introduza um identificador único para o seu ID de Keyspace e depois selecione OK.

   

   

Recuperar as configurações de conexão para sua conta do Azure Cosmos DB

1. Navegue até o portal do Azure em https://portal.azure.com/ e entre.

2. Seleciona Todos os Recursos e depois seleciona a conta Azure Cosmos DB que criaste.

3. Selecione Strings de Ligação e copie os valores dos campos Ponto de Contacto, Porta, Nome de Utilizador e Palavra-passe Principal. Usa esses valores para configurar a sua aplicação mais tarde.

   

Configurar o aplicativo de exemplo

O procedimento a seguir configura o aplicativo de teste.

1. Abra um shell de comando e clone o projeto de exemplo usando um comando git como o exemplo a seguir:

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

2. Localize o ficheiro application.properties no diretório recursos do projeto de exemplo ou crie o ficheiro, caso ainda não exista.

3. Abra o arquivo de application.properties em um editor de texto, adicione ou configure as seguintes linhas no arquivo e substitua os valores de exemplo pelos valores apropriados anteriores:

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

   Onde:

   Parâmetro	Descrição
   spring.data.cassandra.contact-points	Especifica o Ponto de Contato mencionado anteriormente neste artigo.
   spring.data.cassandra.port	Especifica a Porta referida anteriormente neste artigo.
   spring.data.cassandra.username	Especifica o teu Nome de utilizador mencionado anteriormente neste artigo.
   spring.data.cassandra.password	Especifica a sua Senha Principal mencionada anteriormente neste artigo.

4. Salve e feche o ficheiro application.properties.

Empacotar e testar o aplicativo de exemplo

Navegue até o diretório que contém o arquivo pom.xml para criar e testar o aplicativo.

1. Crie o aplicativo de exemplo com o Maven; Por exemplo:

   mvn clean package
   

2. Inicie o aplicativo de exemplo; Por exemplo:

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

3. Crie novos registos usando curl a partir de um símbolo de comando. Os seguintes exemplos mostram como criar registos:

   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
   

   Seu aplicativo deve retornar valores como o exemplo a seguir:

   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. Recupere todos os registos existentes usando curl a partir de um prompt de comandos. Os exemplos seguintes mostram como recuperar registos:

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

   Seu aplicativo deve retornar valores como os seguintes exemplos:

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

Resumo

Neste tutorial, criaste uma aplicação Java de exemplo que usa o Spring Data para armazenar e recuperar informação usando o Azure Cosmos DB para o Apache Cassandra.

Limpar recursos

Quando já não precisares dos recursos, usa o portal do Azure para os apagar. Eliminar os recursos ajuda-o a evitar cobranças inesperadas.

Próximos passos

Para saber mais sobre o Spring e o Azure, continue para o centro de documentação do Spring on Azure.

Ver também

Para obter mais informações sobre como usar o Azure com Java, consulte o Azure for Java Developers e o Trabalhando com o Azure DevOps e o Java.