Aprovisionamiento del rendimiento estándar (manual) de un contenedor de Azure Cosmos DB: API para No SQL

Artículo
08/15/2024

SE APLICA A: NoSQL

En este artículo se explica cómo aprovisionar el rendimiento estándar (manual) en un contenedor en Azure Cosmos DB for NoSQL. Puede aprovisionar el rendimiento de un único contenedor o aprovisionar el de una base de datos y compartirlo entre los contenedores incluidos en ella. Para aprovisionar el rendimiento de un contenedor, use Azure Portal, la CLI de Azure o los SDK de Azure Cosmos DB.

Si usa una API diferente, consulte los artículos API para MongoDB, API para Cassandra y API para Gremlin para aprovisionar el rendimiento.

Azure portal

Inicie sesión en Azure Portal.
Cree una cuenta de Azure Cosmos DB, o bien seleccione una cuenta de Azure Cosmos DB ya existente.
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.

CLI de Azure o PowerShell

Para crear un contenedor con capacidad de procesamiento dedicada, consulte:

.NET SDK

Nota:

Use los SDK de Azure Cosmos DB de la API para NoSQL con el fin de aprovisionar el rendimiento de todas las API de Azure Cosmos DB, excepto Cassandra y la API para MongoDB.

SDK de .NET V2
SDK para .NET V3

// Create a container with a partition key and provision throughput of 400 RU/s
DocumentCollection myCollection = new DocumentCollection();
myCollection.Id = "myContainerName";
myCollection.PartitionKey.Paths.Add("/myPartitionKey");

await client.CreateDocumentCollectionAsync(
    UriFactory.CreateDatabaseUri("myDatabaseName"),
    myCollection,
    new RequestOptions { OfferThroughput = 400 });

// Create a container with a partition key and provision throughput of 1000 RU/s
string containerName = "myContainerName";
string partitionKeyPath = "/myPartitionKey";

await this.cosmosClient.GetDatabase("myDatabase").CreateContainerAsync(
    id: containerName,
    partitionKeyPath: partitionKeyPath,
    throughput: 1000);

SDK de JavaScript

// Create a new Client
const client = new CosmosClient({ endpoint, key });

// Create a database
const { database } = await client.databases.createIfNotExists({ id: "databaseId" });

// Create a container with the specified throughput
const { resource } = await database.containers.createIfNotExists({
id: "containerId",
throughput: 1000
});

// To update an existing container or databases throughput, you need to user the offers API
// Get all the offers
const { resources: offers } = await client.offers.readAll().fetchAll();

// Find the offer associated with your container or the database
const offer = offers.find((_offer) => _offer.offerResourceId === resource._rid);

// Change the throughput value
offer.content.offerThroughput = 2000;

// Replace the offer.
await client.offer(offer.id).replace(offer);

Pasos siguientes

Consulte los siguientes artículos para aprender sobre el aprovisionamiento del rendimiento en Azure Cosmos DB:

Compartir vía