Creación de un contenedor en Azure Cosmos DB para NoSQL mediante JavaScript

Contenedores de azure Cosmos DB almacenan conjuntos de elementos. Para poder crear, consultar o administrar elementos, primero debe crear un contenedor.

Asignar un nombre a un contenedor

En Azure Cosmos DB, un contenedor es análogo a una tabla de una base de datos relacional. Al crear un contenedor, el nombre del contenedor forma un segmento del URI que se usa para acceder al recurso de contenedor y a los elementos secundarios.

Una vez creado, el URI de un contenedor tiene este formato:

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

Creación de un contenedor

Obtenga un objeto Database y, a continuación, cree un contenedor:

• createIfNotExists : crea un contenedor si no existe. Si existe, devuelva el contenedor.
• create : crea un contenedor. Si existe, devuelva statuscode de error.

const containerName = 'myContainer';

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

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

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

Acceso a un contenedor

Se accede a un contenedor desde el objeto Container directamente o encadenado desde los objetos CosmosClient o Database .

const databaseName = 'myDb';
const containerName = 'myContainer';

// Chained - assumes database and container already exis
const { container, statusCode } = await client.database(databaseName).container(containerName);

// Direct - assumes database and container already exist
const { database, statusCode } = await client.database(databaseName);
if(statusCode < 400){
    const { container, statusCode } = await database.container(containerName);
}

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

Acceso por objeto:

• Contenedores (plural): cree o consulte contenedores.
• Contenedor (singular): elimine el contenedor y trabaje con elementos.

Eliminación de un contenedor

Una vez que obtenga el objeto Container , puede usar el objeto Container para eliminar el contenedor:

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

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

Pasos siguientes

Ahora que ha creado un contenedor, use la siguiente guía para crear elementos.