Leer en inglés

Compartir a través de

Inicio rápido: Uso de Azure Cosmos DB para MongoDB (RU) con Node.js

  • Artículo
  • Se aplica a:
    ✅ MongoDB (RU)
Selección de un lenguaje de programación

En este inicio rápido, implementará una aplicación básica de Azure Cosmos DB para MongoDB mediante Python. Azure Cosmos DB para MongoDB es un almacén de datos sin esquema que permite a las aplicaciones almacenar documentos no estructurados en la nube con bibliotecas de MongoDB. Aprenderá a crear documentos y a realizar tareas básicas en el recurso de Azure Cosmos DB mediante Python.

Código fuente de la biblioteca | Paquete (npm) | Azure Developer CLI

Requisitos previos

  • CLI de desarrollo de Azure
  • Docker Desktop
  • Node.js 22 o posteriores

Antes de comenzar, si no tiene una cuenta de Azure, cree una gratuita.

Inicialización del proyecto

Use Azure Developer CLI (azd) para crear una cuenta de Azure Cosmos DB for Table e implementar una aplicación de ejemplo contenedorizada. La aplicación de ejemplo usa la biblioteca cliente para administrar, crear, leer y consultar datos de ejemplo.

  1. Abra un terminal en un directorio vacío.

  2. Si aún no está autenticado, autentíquese en Azure Developer CLI mediante azd auth login. Siga los pasos especificados por la herramienta para autenticarse en la CLI mediante sus credenciales de Azure preferidas.

    Azure CLI 
    azd auth login

  3. Ejecute azd init para inicializar el proyecto.

    Azure CLI 
    azd init --template cosmos-db-mongodb-nodejs-quickstart

  4. Durante la inicialización, configure un nombre de entorno único.

  5. Implemente la cuenta de Azure Cosmos DB mediante azd up. Las plantillas de Bicep también implementan una aplicación web de muestra.

    Azure CLI 
    azd up

  6. Durante el proceso de aprovisionamiento, seleccione la suscripción, la ubicación deseada y el grupo de recursos de destino. Espere a que se complete el proceso de aprovisionamiento. El proceso puede tardar aproximadamente cinco minutos.

  7. Una vez realizado el aprovisionamiento de los recursos de Azure, se incluye una dirección URL a la aplicación web en ejecución en la salida.

    Output 
    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 la dirección URL de la consola para ir a la aplicación web en el explorador. Observe la salida de la aplicación en ejecución.

Captura de pantalla de la aplicación web en ejecución.

Captura de pantalla de la aplicación web en ejecución.

Instalación de la biblioteca cliente

La biblioteca cliente está disponible a través de npm, como paquete de mongodb.

  1. Abra un terminal y vaya a la carpeta /src/ts.

    Bash 
    cd ./src/ts

  2. Si aún no está instalado, instale el paquete mongodb mediante npm install.

    Bash 
    npm install --save mongodb

  3. Abra y revise el archivo src/ts/package.json para validar que existe la entrada mongodb.

  1. Abra un terminal y vaya a la carpeta /src/js.

    Bash 
    cd ./src/js

  2. Si aún no está instalado, instale el paquete mongodb mediante npm install.

    Bash 
    npm install --save mongodb

  3. Abra y revise el archivo src/js/package.json para validar que existe la entrada mongodb.

Modelo de objetos

Nombre Descripción
MongoClient Tipo que se usa para conectarse a MongoDB.
Database Representa una base de datos de la cuenta.
Collection Representa una colección dentro de una base de datos de la cuenta.

Ejemplos de código

El código de ejemplo de la plantilla usa una base de datos denominada cosmicworks y una colección denominada products. La colección products contiene detalles como el nombre, la categoría, la cantidad y un identificador único para cada producto. La colección usa la propiedad /category como clave de partición.

Autenticar el cliente

En este ejemplo se crea una nueva instancia del tipo MongoClient.

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

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

const client = new MongoClient(connectionString);

Obtención de una base de datos

En este ejemplo se crea una instancia del tipo Db mediante la función db del tipo MongoClient.

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

Obtener una colección

En este ejemplo se crea una instancia del tipo Collection mediante la función collection del tipo Db.

Esta función tiene un parámetro genérico que usa el tipo Product definido en una interfaz.

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

Creación de un documento

Cree un documento en la colección mediante collection.updateOne. Este método "actualiza" eficazmente el elemento si ya existe.

TypeScript 
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);
JavaScript 
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);

Lectura de un documento

Realice una operación de lectura de punto mediante el identificador único (id) y los campos de clave de partición. Use collection.findOne para recuperar de forma eficaz el elemento específico.

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

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

var response = await collection.findOne(query);

Consulta de documentos

Realice una consulta en varios elementos de un contenedor mediante collection.find. Esta consulta busca todos los elementos de una categoría especificada (clave de partición).

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

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

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

Exploración de los datos

Use la extensión de Visual Studio Code para Azure Cosmos DB para explorar los datos de MongoDB. Puede realizar operaciones básicas de base de datos, entre las que se incluyen, entre otras:

  • Realizar consultas mediante un libro de recortes o el editor de consultas
  • Modificar, actualizar, crear y eliminar documentos
  • Importar datos masivos desde otros orígenes
  • Administración de bases de datos y colecciones

Para más información, consulte Cómo usar la extensión de Visual Studio Code para explorar datos de Azure Cosmos DB for MongoDB.

Limpieza de recursos

Cuando ya no necesite la aplicación o los recursos de ejemplo, quite la implementación correspondiente y todos los recursos.

Azure CLI 
azd down

Contenido relacionado