Produção padrão de provisão (manual) num recipiente Azure Cosmos - SQL APIProvision standard (manual) throughput on an Azure Cosmos container - SQL API

Este artigo explica como providenciar a produção padrão (manual) num recipiente em Azure Cosmos DB SQL API.This article explains how to provision standard (manual) throughput on a container in Azure Cosmos DB SQL API. Pode provistirá a produção num único contentor, ou provisão de produção numa base de dados e partilhá-la entre os contentores da base de dados.You can provision throughput on a single container, or provision throughput on a database and share it among the containers within the database. Você pode providenciar produção em um recipiente usando o portal Azure CLI, ou Azure Cosmos DB SDKs.You can provision throughput on a container using Azure portal, Azure CLI, or Azure Cosmos DB SDKs.

Se estiver a utilizar uma API diferente, consulte a API para a MongoDB, Cassandra API, artigos da API gremlin para prever o rendimento.If you are using a different API, see API for MongoDB, Cassandra API, Gremlin API articles to provision the throughput.

Portal do AzureAzure portal

  1. Inicie sessão no portal do Azure.Sign in to the Azure portal.

  2. Crie uma nova conta Azure Cosmos,ou selecione uma conta Azure Cosmos existente.Create a new Azure Cosmos account, or select an existing Azure Cosmos account.

  3. Abra o painel do Explorador de Dados e selecione Novo Recipiente.Open the Data Explorer pane, and select New Container. Em seguida, forneça os seguintes detalhes:Next, provide the following details:

    • Indique se está a criar uma nova base de dados ou a utilizar uma existente.Indicate whether you are creating a new database or using an existing one.
    • Introduza uma identificação do contentor.Enter a Container ID.
    • Introduza um valor chave de partição (por exemplo, /ItemID ).Enter a partition key value (for example, /ItemID).
    • Introduza uma produção que pretende prever (por exemplo, 1000 RUs).Enter a throughput that you want to provision (for example, 1000 RUs).
    • Selecione OK.Select OK.

    Screenshot do Data Explorer, com nova coleção em destaque

Azure CLI ou PowerShellAzure CLI or PowerShell

Para criar um recipiente com produção dedicada ver,To create a container with dedicated throughput see,

SDK .NET.NET SDK

Nota

Utilize os SDKs Cosmos para a SQL API para provisão para todas as APIs cosmos, exceto Cassandra e MongoDB API.Use the Cosmos SDKs for SQL API to provision throughput for all Cosmos DB APIs, except Cassandra and MongoDB API.

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

SDK JavaScriptJavaScript 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);

Passos seguintesNext steps

Consulte os seguintes artigos para saber sobre o fornecimento de produção em Azure Cosmos DB:See the following articles to learn about throughput provisioning in Azure Cosmos DB: