Provisionar débito padrão (manual) num contentor do Azure Cosmos DB - API para NoSQL

Este artigo explica como provisionar uma largura de banda padrão (manual) num contentor no Azure Cosmos DB para NoSQL. Pode provisionar throughput num único contentor, ou provisionar throughput numa base de dados e partilhá-lo entre os contentores dentro da base de dados. Pode provisionar throughput num contentor usando Azure Portal, Azure CLI ou Azure Cosmos DB SDKs.

Se estiver a utilizar uma API diferente, consulte os artigos API para MongoDB, API para Cassandra e API para Gremlin para provisionar o throughput.

portal do Azure

1. Inicie sessão no portal Azure.

2. Crie uma nova conta Azure Cosmos DB ou selecione uma conta Azure Cosmos DB existente.

3. Abra o painel Data Explorer e selecione New Container. Em seguida, forneça os seguintes detalhes:

   • Indique se está a criar uma nova base de dados ou a usar uma já existente.
   • Introduza um ID de contentor.
   • Introduza um valor de Partition key (por exemplo, /ItemID).
   • Selecione Autoscale ou Manual, e insira a largura de banda do Contentor exigida (por exemplo, 1000 RU/s). Insira uma taxa de transferência que deseja provisionar (por exemplo, 1000 RUs).
   • Selecione OK.

   

Azure CLI ou PowerShell

Para criar um contentor com throughput dedicado, consulte a documentação apropriada ou siga as instruções seguintes.

• Crie um contentor usando Azure CLI
• Crie um contentor usando PowerShell

SDK para .NET

// 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);

JavaScript SDK

// 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);

Próximos passos

Consulte os seguintes artigos para saber mais sobre o provisionamento de throughput no Azure Cosmos DB:

• Como configurar o throughput padrão (manual) numa base de dados
• Como configurar a escalabilidade automática da largura de banda numa base de dados
• Unidades de pedido e débito no Azure Cosmos DB