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.
Abra um terminal em um diretório vazio.
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
Execute
azd init
para inicializar o projeto.azd init --template cosmos-db-mongodb-nodejs-quickstart
Durante a inicialização, configure um nome de ambiente exclusivo.
Implante a conta do Azure Cosmos DB usando
azd up
. Os modelos do Bicep também implantam um aplicativo Web de exemplo.azd up
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.
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.
Use a URL no console para navegar até seu aplicativo Web no navegador. Observe a saída do aplicativo em execução.
Instalar a biblioteca de clientes
A biblioteca de clientes está disponível através do npm, como o pacote mongodb
.
Abra um terminal e vá até a pasta
/src/ts
.cd ./src/ts
Se o pacote
mongodb
ainda não estiver instalado, instale-o usandonpm install
.npm install --save mongodb
Abra e revise o arquivo src/ts/package.json para validar se a entrada
mongodb
existe.
Abra um terminal e vá até a pasta
/src/js
.cd ./src/js
Se o pacote
mongodb
ainda não estiver instalado, instale-o usandonpm install
.npm install --save mongodb
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
- Autenticar o cliente
- Obter um banco de dados
- Obter uma coleção
- Criar um documento
- Obter um documento
- Consultar documentos
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