Taxa de transferência padrão (manual) de provisionamento em um contêiner do Azure Cosmos DB - API para 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 para NoSQL. Você pode 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 dentro do banco de dados. Você pode provisionar a taxa de transferência em um contêiner usando o portal do Azure, a CLI do Azure ou os SDKs do Azure Cosmos DB.

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

Portal do Azure

1. Inicie sessão no portal do Azure.

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

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

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

   

CLI do Azure ou PowerShell

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

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

SDK do .NET

Nota

Use os SDKs do Azure Cosmos DB para API for NoSQL para provisionar a taxa de transferência para todas as APIs do Azure Cosmos DB, exceto Cassandra e API para MongoDB.

SDK do .NET V2

// 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 do .NET V3

// 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 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óximos passos

Consulte 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 pedido e débito no Azure Cosmos DB