Partilhar via


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

  • 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.

    Portal do Azure, crie um recurso, selecione a opção 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.
    • 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.

    Reveja as definições da sua conta do Azure Cosmos DB.

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.

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

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.

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).