Creación de una base de datos en Azure Cosmos DB for NoSQL mediante JavaScript

SE APLICA A: NoSQL

Las bases de datos de Azure Cosmos DB son unidades de administración para uno o varios contenedores. Para poder crear o administrar contenedores, primero debe crear una base de datos.

Asignación de nombre a una base de datos

En Azure Cosmos DB, una base de datos es análoga a un espacio de nombres. Al crear una base de datos, el nombre de la base de datos forma un segmento del URI utilizado para acceder al recurso de base de datos y a los recursos secundarios.

Una vez creado, el URI de una base de datos tiene este formato:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>

Crear una base de datos

Una vez creado CosmosClient, use el cliente para crear una Base de datos a partir de dos llamadas diferentes:

• createIfNotExists: crea una base de datos si no existe una. Si existe, devuelva la base de datos.
• create: crea una base de datos. Si existe, devuelva el error statusCode.

const databaseName = 'myDb';

// Possible results:
// Create then return database
// Return existing database
// Return error statusCode
const {statusCode, database } = await client.databases.createIfNotExists({ id: databaseName });

// Possible results: 
// Create then return database
// Return error statusCode, reason includes database already exists
const {statusCode, database } = await client.databases.create({ id: databaseName });

StatusCode es un código de respuesta HTTP. Una respuesta correcta está en el intervalo 200-299.

Acceso a una base de datos

Se tiene acceso a una base de datos desde el objeto de Base de datos directamente o a través de un resultado de consulta de CosmosClient.

const databaseName = 'myDb';

// Direct - assumes database already exists
const { database, statusCode } = await client.database(databaseName);

// Query - assumes database already exists   
const { resources } = await client.databases
.query({
    query: `SELECT * FROM root r where r.id =@dbId`,
    parameters: [
    {
        name: '@dbId',
        value: databaseName
    }
    ]
})
.fetchAll();

Acceso por medio de un objeto:

• Databases (plural): se usa para crear nuevas bases de datos, o consultar o leer todas las bases de datos.
• Database (singular): se usa para leer, actualizar o eliminar una base de datos existente mediante el identificador o acceder a contenedores pertenecientes a esa base de datos.

Eliminación de una base de datos

Una vez que obtenga el objeto de Base de datos, puede usar el objeto de base de datos para eliminar la base de datos:

const {statusCode } = await database.delete();

StatusCode es un código de respuesta HTTP. Una respuesta correcta está en el intervalo 200-299.

Pasos siguientes

Ahora que ha creado una base de datos, use la siguiente guía para crear contenedores.

Creación de un contenedor