Provisionar a taxa de transferência padrão (manual) em um contêiner do Azure Cosmos DB – API de NoSQL

APLICA-SE A: NoSQL

Este artigo explica como provisionar a taxa de transferência padrão (manual) em um contêiner no Azure Cosmos DB for NoSQL. É possível provisionar a taxa de transferência em um único contêiner ou provisionar a taxa de transferência em um banco de dados e compartilhá-la entre os contêineres no banco de dados. É possível provisionar a taxa de transferência em um contêiner usando o portal do Azure, a CLI do Azure ou SDKs do Azure Cosmos DB.

Se você estiver usando uma API diferente, confira os artigos API do MongoDB, API do Cassandra e API do Gremlin para provisionar a taxa de transferência.

Portal do Azure

1. Entre no portal do Azure.

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

3. Abra o painel Data Explorer e selecione Novo Contêiner. Em seguida, forneça os seguintes detalhes:

   • Indique se você está criando um banco de dados ou usando um existente.
   • Insira um ID de contêiner.
   • Insira um valor de chave de partição (por exemplo, /ItemID).
   • Selecione a taxa de transferência com Dimensionamento automático ou Manual e insira a Taxa de transferência do contêiner necessária (por exemplo, 1000 RU/s). Insira uma taxa de transferência que você deseja provisionar (por exemplo, 1.000 RUs).
   • Selecione OK.

   

CLI do Azure ou PowerShell

Para criar um contêiner com taxa de transferência dedicada confira,

• Criar um contêiner com a CLI do Azure
• Criar um contêiner com o PowerShell

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

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

Próximas etapas

Confira os seguintes artigos para saber mais sobre o provisionamento de taxa de transferência no Azure Cosmos DB:

• Como provisionar a taxa de transferência padrão (manual) em um banco de dados
• Como provisionar a taxa de transferência de dimensionamento automático em um banco de dados
• Unidades de solicitação e taxa de transferência no Azure Cosmos DB