Partilhar via

Guia de início rápido: usar o Azure Cosmos DB para MongoDB (RU) com .NET

  • Artigo
  • Aplica-se a:
    ✅ MongoDB (RU)

Neste início rápido, você implanta um aplicativo básico do Azure Cosmos DB para MongoDB usando Python. O Azure Cosmos DB para MongoDB é um armazenamento de dados sem esquema que permite que os aplicativos armazenem documentos não estruturados na nuvem com bibliotecas do MongoDB. Você aprende a criar documentos e executar tarefas básicas em seu recurso do Azure Cosmos DB usando Python.

Pacote de código-fonte da biblioteca (NuGet) | Azure Developer CLI |

Pré-requisitos

  • Azure Developer CLI
  • Área de trabalho do Docker
  • .NET SDK 9.0

Se não tiver uma conta do Azure, crie uma conta gratuita antes de começar.

Inicializar o projeto

Use a CLI do Desenvolvedor do Azure (azd) para criar uma conta do Azure Cosmos DB for Table e implantar um aplicativo de exemplo em contêiner. O aplicativo de exemplo usa a biblioteca de cliente para gerenciar, criar, ler e consultar dados de exemplo.

  1. Abra um terminal em um diretório vazio.

  2. Se você ainda não estiver autenticado, autentique-se na CLI do Desenvolvedor do Azure usando azd auth logino . Siga as etapas especificadas pela ferramenta para autenticar na CLI usando suas credenciais preferidas do Azure.

    azd auth login

  3. Use azd init para inicializar o projeto.

    azd init --template cosmos-db-mongodb-dotnet-quickstart

  4. Durante a inicialização, configure um nome de ambiente exclusivo.

  5. Implante a conta do Azure Cosmos DB usando azd upo . Os modelos Bicep também implantam um aplicativo Web de exemplo.

    azd up

  6. Durante o processo de provisionamento, selecione sua assinatura, o local desejado e o grupo de recursos de destino. Aguarde a conclusão do processo de provisionamento. O processo pode levar aproximadamente cinco minutos.

  7. Depois que o provisionamento dos recursos do Azure for concluído, uma URL para o aplicativo Web em execução será incluída na saída.

    Deploying services (azd deploy)

  (✓) Done: Deploying service web
- Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>

SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.

  8. Use o URL no console para navegar até seu aplicativo Web no navegador. Observe a saída do aplicativo em execução.

Captura de tela do aplicativo Web em execução.

Instalar a biblioteca de cliente

A biblioteca do cliente está disponível através do NuGet, como o MongoDB.Driver pacote.

  1. Abra um terminal e navegue até a /src/web pasta.

    cd ./src/web

  2. Se ainda não estiver instalado, instale o pacote usando dotnet add packageo MongoDB.Driver .

    dotnet add package MongoDB.Driver

  3. Abra e revise o arquivo src/web/Microsoft.Samples.Cosmos.MongoDB.Quickstart.Web.csproj para validar que a MongoDB.Driver entrada existe.

Modelo de objeto

Nome Descrição
MongoClient Tipo usado para se conectar ao MongoDB.
Database Representa um banco de dados na conta.
Collection Representa uma coleção dentro de um banco de dados na conta.

Exemplos de código

O código de exemplo no modelo usa um banco de dados chamado cosmicworks e uma coleção chamada products. A products coleção contém detalhes como nome, categoria, quantidade e um identificador exclusivo para cada produto. A coleção usa a /category propriedade como uma chave de estilhaço.

Autenticar o cliente

Este exemplo cria uma nova instância da MongoClient classe.

string connectionString = "<azure-cosmos-db-for-mongodb-connection-string>";

MongoClient client = new(connectionString);

Obter uma base de dados

Este exemplo cria uma instância da IMongoDatabase interface usando o GetDatabase método da MongoClient classe.

IMongoDatabase database = client.GetDatabase("<database-name>");

Obter uma coleção

Este exemplo cria uma instância da interface genérica IMongoCollection<> usando o GetCollection<> método genérico da IMongoDatabase interface. A interface genérica e o método usam um tipo nomeado Product definido em outra classe.

IMongoCollection<Product> collection = database.GetCollection<Product>("<collection-name>");

public record Product(
    string id,
    string category,
    string name,
    int quantity,
    decimal price,
    bool clearance
);

Criar um documento

Crie um documento na coleção usando collection.ReplaceOneAsync<> o parâmetro generic Product type. Este método "upserts" o item efetivamente substituindo o item se ele já existe.

Product document = new(
    id: "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
    category: "gear-surf-surfboards",
    name: "Yamba Surfboard",
    quantity: 12,
    price: 850.00m,
    clearance: false
);

await collection.ReplaceOneAsync<Product>(
    d => d.id == document.id,
    document,
    new ReplaceOptions { IsUpsert = true }
);

Ler um documento

Execute uma operação de leitura pontual usando o identificador exclusivo (id) e os campos de chave de estilhaço. Use collection.FindAsync<> com o parâmetro de tipo genérico Product para recuperar eficientemente o item específico.

IAsyncCursor<Product> documents = await collection.FindAsync<Product>(
    d => d.id == "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" && d.category == "gear-surf-surfboards"
);

Product? document = await documents.SingleOrDefaultAsync();

Consultar documentos

Execute uma consulta sobre vários itens em um contêiner usando collection.AsQueryable() a consulta integrada ao idioma (LINQ). Esta consulta localiza todos os itens dentro de uma categoria especificada (chave de estilhaço).

IQueryable<Product> documents = collection.AsQueryable().Where(
    d => d.category == "gear-surf-surfboards"
);

foreach (Product document in await documents.ToListAsync())
{
    // Do something with each item
}

Explore os seus dados

Use a extensão de código do Visual Studio para o Azure Cosmos DB para explorar seus dados do MongoDB. Você pode executar operações principais do banco de dados, incluindo, mas não limitado a:

  • Executando consultas usando um álbum de recortes ou o editor de consultas
  • Modificar, atualizar, criar e excluir documentos
  • Importando dados em massa de outras fontes
  • Gerenciando bancos de dados e coleções

Para obter mais informações, consulte Como usar a extensão de código do Visual Studio para explorar o Azure Cosmos DB para dados do MongoDB.

Clean up resources (Limpar recursos)

Quando você não precisar mais do aplicativo ou recursos de exemplo, remova a implantação correspondente e todos os recursos.

azd down

Conteúdos relacionados