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

  • Artigo

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

  • Um cliente Git.

Criar uma conta do Azure Cosmos DB

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

Observação

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

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

  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.

    Portal do Azure, crie um recurso, selecione a opção de API, Azure Cosmos DB para MongoDB selecionado.

  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.
    • Local: especifique a região geográfica mais próxima do banco de dados.

  5. Depois de inserir todas as informações acima, clique em Revisar + criar.

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

    Revise suas configurações de conta do Azure Cosmos DB.

Recuperar a cadeia de conexão da conta do Azure Cosmos DB

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

  2. Clique em Todos os Recursos e, em seguida, clique na conta do Azure Cosmos DB que você acabou de criar.

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

    Recupere sua cadeia de conexão do Azure Cosmos DB.

Configurar o aplicativo de exemplo

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

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

  2. Crie um diretório recursos no diretório <raiz do projeto>/complete/src/main do exemplo de projeto e crie um arquivo application.properties no diretório recursos.

  3. Abra o arquivo application.properties em um editor de texto e adicione as seguintes linhas ao arquivo e substitua os valores de exemplo pelos valores adequados do início do artigo:

    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 Descrição
    spring.data.mongodb.database Especifica o nome da sua conta do Azure Cosmos DB da versão anterior deste artigo.
    spring.data.mongodb.uri Especifica a Cadeia de conexão primária referida anteriormente neste artigo.

  4. Salve e feche o arquivo application.properties.

Empacotar e testar o aplicativo de exemplo

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

  1. Compile o aplicativo de exemplo com o Maven e configure o Maven para ignorar os testes. Por exemplo:

    mvn clean package -DskipTests

  2. Inicie o aplicativo de exemplo. Por exemplo:

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

    Seu aplicativo deve retornar 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.

Limpar os recursos

Quando não for mais necessário, use o portal do Azure para excluir os recursos criados neste artigo para evitar cobranças inesperadas.

Próximas etapas

Para saber mais sobre o Spring e o Azure, continue no Spring no Centro de Documentação do Azure.

Spring no Azure

Confira também

Para obter mais informações sobre como usar o Azure com Java, confira Azure para Desenvolvedores Java e Como trabalhar com o Java e o Azure DevOps.