Introducción a Azure Cosmos DB para NoSQL mediante JavaScript

En este artículo se muestra cómo conectarse a Azure Cosmos DB para NoSQL mediante el SDK de JavaScript. Una vez conectado, puede realizar operaciones en bases de datos, contenedores y elementos.

Paquete (npm) | Referencia de la API | Código fuente de la biblioteca | Enviar comentarios

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Cuenta de Azure Cosmos DB for NoSQL. Cree una API para la cuenta noSQL.
• Node.js LTS
• Interfaz de la línea de comandos (CLI) de Azure o Azure PowerShell

Configure su proyecto local

1. Cree un nuevo directorio para su proyecto de JavaScript en un shell Bash.

   mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples
   

2. Cree una nueva aplicación de JavaScript mediante el npm init comando con la plantilla de consola .

   npm init -y
   

3. Instale la dependencia necesaria para el SDK de JavaScript de Azure Cosmos DB para NoSQL.

   npm install @azure/cosmos
   

Conéctate a Azure Cosmos DB para NoSQL

Para conectarse a la API para NoSQL de Azure Cosmos DB, cree una instancia de la CosmosClient clase . Esta clase es el punto inicial para realizar todas las operaciones en bases de datos.

Para conectarse a la API de la cuenta NoSQL mediante Microsoft Entra, use una entidad de seguridad. El tipo exacto de entidad de seguridad dependerá de dónde hospede el código de la aplicación. La tabla siguiente sirve como guía de referencia rápida.

Importar @azure/identity

El paquete npm de @azure/identity contiene la funcionalidad de autenticación principal que se comparte entre todas las bibliotecas del SDK de Azure.

1. Importe el paquete npm de @azure/identity mediante el npm install comando .

   npm install @azure/identity
   

2. En el editor de código, agregue las dependencias.

   const { DefaultAzureCredential } = require("@azure/identity");
   

Creación de CosmosClient con la implementación de credenciales predeterminada

Si está probando en una máquina local o la aplicación se va a ejecutar en servicios de Azure con compatibilidad directa con identidades administradas, obtenga un token de OAuth mediante la creación de una instancia de DefaultAzureCredential. A continuación, cree una nueva instancia de la clase CosmosClient con la COSMOS_ENDPOINT variable de entorno y el objeto TokenCredential como parámetros.

const { CosmosClient } = require("@azure/cosmos");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

Compilación de la aplicación

A medida que compile la aplicación, el código interactuará principalmente con cuatro tipos de recursos:

• La cuenta de API para NoSQL, que es el espacio de nombres único de nivel superior para los datos de Azure Cosmos DB.

• Bases de datos, que organizan los contenedores de la cuenta.

• Contenedores, que contienen un conjunto de elementos individuales en la base de datos.

• Elementos, que representan un documento JSON en tu contenedor.

En el diagrama siguiente se muestra la relación entre estos recursos.

Cada tipo de recurso se representa mediante una o varias clases asociadas. Esta es una lista de las clases más comunes:

En las siguientes guías se muestra cómo usar cada una de estas clases para compilar la aplicación.

Consulte también

• Paquete de npm
• Referencia de las API
• Código fuente de la biblioteca
• Envíenos sus comentarios

Pasos siguientes