Início rápido: Use o Azure Cosmos DB para MongoDB com Node.js

• .NET
• Node.js
• Python

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.

Código fonte da biblioteca | Pacote (npm) | CLI para Desenvolvedores Azure

Prerequisites

• Azure Developer CLI
• Área de trabalho do Docker
• Node.js 22 ou superior

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. Caso ainda não esteja autenticado, autentique-se no Azure Developer CLI usando azd auth login. 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-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 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.

Instalar a biblioteca de cliente

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

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

   cd ./src/ts
   

2. Se ainda não estiver instalado, instale o pacote usando mongodbnpm install.

   npm install --save mongodb
   

3. Abra e reveja o ficheiro src/ts/package.json para validar se a entrada mongodb existe.

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

   cd ./src/js
   

2. Se ainda não estiver instalado, instale o pacote usando mongodbnpm install.

   npm install --save mongodb
   

3. Abra e reveja o ficheiro src/js/package.json para validar que a entrada mongodb existe.

Importar bibliotecas

Importe o tipo MongoClient para o código da aplicação.

import { MongoClient } from 'mongodb';

Importe todos os tipos necessários para o código da aplicação.

import { Collection, Db, Filter, FindCursor, MongoClient, UpdateFilter, UpdateOptions, UpdateResult, WithId } from 'mongodb';

Modelo de objeto

Name	Description
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

• Autenticar o cliente
• Obter uma base de dados
• Obter uma coleção
• Criar um documento
• Obter um documento
• Consultar documentos

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 fragmentação.

Autenticar o cliente

Este exemplo cria uma nova instância do MongoClient tipo.

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 uma base de dados

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

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

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

Obter uma coleção

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

Esta função tem um parâmetro genérico que usa o Product tipo 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. Este método "insere ou atualiza" o item, substituindo-o efetivamente se ele já existir.

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 pontual usando o identificador exclusivo (id) e os campos de chave de fragmentação. Use collection.findOne para recuperar eficientemente 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

Efectuar uma consulta a vários itens num contentor usando collection.find. Esta consulta localiza todos os itens dentro de uma categoria especificada (chave de estilhaç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
}

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.

Limpeza de recursos

Quando já não precisar da aplicação ou dos recursos de amostra, remova a implementação correspondente e todos os recursos.

azd down --force --purge

Conteúdo relacionado

• Guia de início rápido do .NET
• Início Rápido do Python