Creación de un contenedor en Azure Cosmos DB for NoSQL

  • Artículo

SE APLICA A: NoSQL

En este artículo se explican las distintas formas de crear un contenedor en Azure Cosmos DB for NoSQL. Muestra cómo crear un contenedor mediante Azure Portal, la CLI de Azure, PowerShell o los SDK admitidos. En este artículo se muestra cómo crear un contenedor, especificar la clave de partición y aprovisionar el rendimiento.

En este artículo se explican las distintas formas de crear un contenedor en Azure Cosmos DB for NoSQL. Si usa una API diferente, consulte los artículos API para MongoDB, API para Cassandra, API para Gremlin y API para Table para crear el contenedor.

Nota:

Cuando cree contenedores, asegúrese de no utilizar el mismo nombre en dos de ellos con distintas mayúsculas y minúsculas. Algunos componentes de la plataforma de Azure no distinguen mayúsculas de minúsculas y esto puede producir confusión o problemas con los datos de telemetría y las acciones que se realicen en los contenedores con estos nombres.

Creación de un contenedor mediante Azure Portal

  1. Inicie sesión en Azure Portal.

  2. Cree una nueva cuenta de Azure Cosmos DB o seleccione una existente.

  3. Abra el panel Data Explorer y seleccione Nuevo contenedor. Después, proporcione los detalles siguientes:

    • Indique si va a crear una nueva base de datos o a usar una existente.
    • Escriba un valor en Container Id (Id. de contenedor).
    • Escriba un valor en Partition key (Clave de partición) (por ejemplo, /ItemID).
    • Seleccione un rendimiento de Autoscale (Escalabilidad automática) o Manual y especifique el valor de Container throughput (Rendimiento de contenedor) (por ejemplo, 1000 RU/s). Escriba un rendimiento que quiera aprovisionar (por ejemplo, 1000 RU).
    • Seleccione Aceptar.

    Screenshot of Data Explorer, with New Collection highlighted

Creación de un contenedor mediante la CLI de Azure

Cree un contenedor con la CLI de Azure. Para obtener una lista de todos los ejemplos de la CLI de Azure en todas las API de Azure Cosmos DB, vea Ejemplos de la CLI de Azure para Azure Cosmos DB.

Creación de un contenedor mediante PowerShell

Cree un contenedor con PowerShell. Para obtener una lista de todos los ejemplos de PowerShell en todas las API de Azure Cosmos DB, vea Ejemplos de PowerShell.

Creación de un contenedor mediante el SDK para .NET

Si se produce una excepción de tiempo de espera al crear una colección, realice una operación de lectura para validar si la colección se ha creado correctamente. La operación de lectura emite una excepción hasta que la operación de creación de la colección se realiza correctamente. Para la lista de códigos de estado admitidos por la operación de creación, consulte el artículo Códigos de estado HTTP para Azure Cosmos DB.

// Create a container with a partition key and provision 400 RU/s manual throughput.
CosmosClient client = new CosmosClient(connectionString, clientOptions);
Database database = await client.CreateDatabaseIfNotExistsAsync(databaseId);

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = containerId,
    PartitionKeyPath = "/myPartitionKey"
};

var throughput = ThroughputProperties.CreateManualThroughput(400);
Container container = await database.CreateContainerIfNotExistsAsync(containerProperties, throughput);

Pasos siguientes