Usar dados de primavera com o Azure Cosmos DB para a API do MongoDB

Este artigo demonstra a criação de um aplicativo de exemplo que usa o Spring Data para armazenar e recuperar informações usando o Azure Cosmos DB para MongoDB.

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.

Criar uma conta do Azure Cosmos DB

Criar uma conta do Azure Cosmos DB com o portal do Azure

Nota

Você pode ler informações mais detalhadas sobre como criar contas na documentação do Azure Cosmos DB.

1. Navegue para o portal do Azure em https://portal.azure.com/ e inicie sessão.

2. Selecione Criar um recurso, Bancos de Dados e Azure Cosmos DB.

3. Na tela de opção Selecionar API, selecione Azure Cosmos DB para MongoDB.

   

4. Especifique as seguintes informações:

   • Assinatura: especifique sua assinatura do Azure a ser usada.
   • Grupo de recursos: especifique se deseja criar um novo grupo de recursos ou escolher um grupo de recursos existente.
   • Nome da conta: escolha um nome exclusivo para sua conta do Azure Cosmos DB, que será usado para criar um nome de domínio totalmente qualificado, como wingtiptoysmongodb.documents.azure.com.
   • API: especifique Azure Cosmos DB for MongoDB API para este tutorial.
   • Localização: especifique a região geográfica mais próxima para o banco de dados.

5. Quando tiver inserido todas as informações acima, clique em Rever + criar.

6. Se estiver tudo certo na página de revisão, clique em Criar.

   

Obter a cadeia de ligação da conta do Azure Cosmos DB

1. Navegue para o portal do Azure em https://portal.azure.com/ e inicie sessão.

2. Clique em Todos os Recursos e na conta do Azure Cosmos DB que acabou de criar.

3. Clique em Cadeias de conexão e copie o valor para o campo Cadeia de conexão primária, você usará esse valor para configurar seu aplicativo mais tarde.

   

Configurar o exemplo de aplicação

1. Abra uma shell de comandos e clone o exemplo de projeto com um comando git como no seguinte exemplo:

   git clone https://github.com/spring-guides/gs-accessing-data-mongodb.git
   

2. Crie o diretório resources no diretório <project root>/complete/src/main do projeto de exemplo e crie um ficheiro application.properties no diretório resources.

3. Abra o ficheiro application.properties num editor de texto, adicione as seguintes linhas no ficheiro e substitua os exemplos de valores pelos valores adequados utilizados anteriormente:

   spring.data.mongodb.database=wingtiptoysmongodb
   spring.data.mongodb.uri=mongodb://wingtiptoysmongodb:AbCdEfGhIjKlMnOpQrStUvWxYz==@wingtiptoysmongodb.documents.azure.com:10255/?ssl=true&replicaSet=globaldb
   

   Em que:

   Parâmetro	Description
   spring.data.mongodb.database	Especifica o nome da sua conta do Azure Cosmos DB do início deste artigo.
   spring.data.mongodb.uri	Especifica a Cadeia de Ligação Principal especificada anteriormente neste artigo.

4. Guarde e feche o ficheiro application.properties.

Empacotar e testar o exemplo de aplicação

Para construir o aplicativo, navegue até o diretório /gs-accessing-data-mongodb/complete, que contém o arquivo pom.xml .

1. Compile o exemplo de aplicação com o Maven e configure este para ignorar os testes; por exemplo:

   mvn clean package -DskipTests
   

2. Inicie o exemplo de aplicação; por exemplo:

   
   java -jar target/accessing-data-mongodb-complete-0.0.1-SNAPSHOT.jar
   

   A sua aplicação deverá devolver valores como os seguintes:

   Customers found with findAll():
   -------------------------------
   Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
   Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']
   
   Customer found with findByFirstName('Alice'):
   --------------------------------
   Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
   Customers found with findByLastName('Smith'):
   --------------------------------
   Customer[id=5c1b4ae4d0b5080ac105cc13, firstName='Alice', lastName='Smith']
   Customer[id=5c1b4ae4d0b5080ac105cc14, firstName='Bob', lastName='Smith']
   

Resumo

Neste tutorial, você criou um aplicativo Java de exemplo que usa o Spring Data para armazenar e recuperar informações usando o Azure Cosmos DB para MongoDB.

Clean up resources (Limpar recursos)

Utilize o portal do Azure para eliminar os recursos criados neste artigo que deixaram de ser necessários para evitar custos inesperados.

Próximos passos

Para saber mais sobre o Spring e o Azure, avance para o centro de documentação relativa ao Spring no Azure.

Spring no Azure

Consulte também

Para obter mais informações sobre a utilização do Azure com Java, veja Azure para Programadores de Java e Working with Azure DevOps and Java (Trabalhar com o Azure DevOps e Java).