Compartilhar via


Início Rápido: Usar o Azure Cosmos DB for MongoDB (RU) com Node.js

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

Código-fonte da biblioteca | Pacote (npm) | Azure Developer CLI

Pré-requisitos

  • CLI do Desenvolvedor do Azure
  • Docker Desktop
  • Node.js 22 ou mais recente

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

Inicializar o projeto

Use a Azure Developer CLI (azd) para criar uma conta do Azure Cosmos DB for Table e implantar um aplicativo de exemplo em contêineres. O aplicativo de exemplo usa a biblioteca de clientes 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 Azure Developer CLI usando azd auth login. Siga as etapas especificadas pela ferramenta para se autenticar na CLI usando suas credenciais preferenciais do Azure.

    azd auth login
    
  3. Execute azd init para inicializar o projeto.

    azd init --template cosmos-db-mongodb-nodejs-quickstart
    
  4. Durante a inicialização, configure um nome de ambiente exclusivo.

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

    azd up
    
  6. Durante o processo de provisionamento, selecione a sua assinatura, o local desejado e o grupo de recursos de destino. Aguarde o processo de provisionamento ser concluído. 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 a 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.

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

Instalar a biblioteca de clientes

A biblioteca de clientes está disponível através do npm, como o pacote mongodb.

  1. Abra um terminal e vá até a pasta /src/ts.

    cd ./src/ts
    
  2. Se o pacote mongodb ainda não estiver instalado, instale-o usando npm install.

    npm install --save mongodb
    
  3. Abra e revise o arquivo src/ts/package.json para validar se a entrada mongodb existe.

  1. Abra um terminal e vá até a pasta /src/js.

    cd ./src/js
    
  2. Se o pacote mongodb ainda não estiver instalado, instale-o usando npm install.

    npm install --save mongodb
    
  3. Abra e revise o arquivo src/js/package.json para validar se a entrada mongodb 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 amostra do modelo usa um banco de dados chamado cosmicworks e um contêiner chamado products. A coleção products contém detalhes como nome, categoria, quantidade e um identificador exclusivo para cada produto. A coleção usa a propriedade /category como uma chave de fragmento.

Autenticar o cliente

Esta amostra cria uma nova instância do tipo MongoClient.

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

const client = new MongoClient(connectionString);
const connectionString = "<azure-cosmos-db-for-mongodb-connection-string>";

const client = new MongoClient(connectionString);

Obter um banco de dados

Esta amostra cria uma instância do tipo Db usando a função db do tipo MongoClient.

const database: Db = client.db("<database-name>");
const database = client.db("<database-name>");

Obter uma coleção

Esta amostra cria uma instância do tipo Collection usando a função collection do tipo Db.

Essa função tem um parâmetro genérico que usa o tipo Product definido em uma interface.

const collection: Collection<Product> = database.collection<Product>("<collection-name>");
export interface Product {
    _id: string;
    category: string;
    name: string;
    quantity: number;
    price: number;
    clearance: boolean;
}
const collection = database.collection("<collection-name>");

Criar um documento

Crie um documento na coleção usando collection.updateOne. Esse método executa upsert no item, substituindo o item efetivamente caso ele já exista.

var document: Product = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards',
    name: 'Yamba Surfboard',
    quantity: 12,
    price: 850.00,
    clearance: false
};

var query: Filter<Product> = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards'
};
var payload: UpdateFilter<Product> = {
    $set: document
};
var options: UpdateOptions = {
    upsert: true
};
var response: UpdateResult<Product> = await collection.updateOne(query, payload, options);
var document = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards',
    name: 'Yamba Surfboard',
    quantity: 12,
    price: 850.00,
    clearance: false
};

const query = {
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
    category: 'gear-surf-surfboards'
};
const payload = {
    $set: document
};
const options = {
    upsert: true,
    new: true
};
var response = await collection.updateOne(query, payload, options);

Ler um documento

Realize uma operação de leitura de ponto usando o identificador exclusivo (id) e os campos de chave de extensão. Use collection.findOne para recuperar com eficiência o item específico.

var query: Filter<Product> = { 
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb', 
    category: 'gear-surf-surfboards' 
};

var response: WithId<Product> | null = await collection.findOne(query);
var query = { 
    _id: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb', 
    category: 'gear-surf-surfboards' 
};

var response = await collection.findOne(query);

Consultar documentos

Realize uma consulta em vários itens de um contêiner usando collection.find. Essa consulta localiza todos os itens dentro de uma categoria especificada (chave de extensão).

var query: Filter<Product> = { 
    category: 'gear-surf-surfboards' 
};

var response: FindCursor<WithId<Product>> = await collection.find(query);
for await (const item of response) {
    // Do something with each item
}
var query = { 
    category: 'gear-surf-surfboards' 
};

var response = await collection.find(query);
for await (const item of response) {
    // Do something with each item
}

Explorar seus dados

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

  • Executar consultas usando um scrapbook ou o editor de consultas
  • Modificar, atualizar, criar e excluir documentos
  • Importar dados em massa de outras fontes
  • Criar bancos de dados e coleções

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

Limpar os recursos

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

azd down