Provisionar a taxa de transferência de banco de dados, contêiner ou dimensionamento automático em recursos do Azure Cosmos DB for MongoDB

Artigo
06/01/2023

APLICA-SE A: MongoDB

Este artigo explica como provisionar a taxa de transferência no Azure Cosmos DB for MongoDB. É possível provisionar a taxa de transferência padrão (manual) ou de dimensionamento automático em um contêiner ou 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 NoSQL, API do Cassandra e API do Gremlin para provisionar a taxa de transferência.

Portal do Azure

Entre no portal do Azure.
Crie uma conta do Azure Cosmos DB ou selecione uma existente.
Abra o painel Data Explorer e selecione Nova Coleção. Em seguida, forneça os seguintes detalhes:
- Indique se você está criando um banco de dados ou usando um existente. Selecione a opção Provisionar taxa de transferência do banco de dados se você quiser provisionar a taxa de transferência no nível do banco de dados.
- Insira uma ID de coleção.
- Insira um valor de chave de partição (por exemplo, ItemID).
- Insira uma taxa de transferência que você deseja provisionar (por exemplo, 1.000 RUs).
- Selecione OK.

Observação

Se você estiver provisionando a taxa de transferência em um contêiner em uma conta do Azure Cosmos DB configurada com o Azure Cosmos DB for MongoDB, use myShardKey para o caminho da chave de partição.

SDK .NET

// refer to MongoDB .NET Driver
// https://docs.mongodb.com/drivers/csharp

// Create a new Client
String mongoConnectionString = "mongodb://DB AccountName:Password@DB AccountName.documents.azure.com:10255/?ssl=true&replicaSet=globaldb";
mongoUrl = new MongoUrl(mongoConnectionString);
mongoClientSettings = MongoClientSettings.FromUrl(mongoUrl);
mongoClient = new MongoClient(mongoClientSettings);

// Change the database name
mongoDatabase = mongoClient.GetDatabase("testdb");

// Change the collection name, throughput value then update via MongoDB extension commands
// https://learn.microsoft.com/azure/cosmos-db/mongodb-custom-commands#update-collection

var result = mongoDatabase.RunCommand<BsonDocument>(@"{customAction: ""UpdateCollection"", collection: ""testcollection"", offerThroughput: 400}");

Azure Resource Manager

Modelos do Azure Resource Manager podem ser usados para provisionar a taxa de transferência de dimensionamento automático em recursos no nível do banco de dados ou do contêiner para todas as APIs do Azure Cosmos DB. Confira Modelos do Azure Resource Manager para o Azure Cosmos DB para exemplos.

CLI do Azure

A CLI do Azure pode ser usada para provisionar a taxa de transferência de dimensionamento automático em um banco de dados ou recursos em nível de contêiner para todas as APIs do Azure Cosmos DB. Para exemplos, confira Exemplos da CLI do Azure para Azure Cosmos DB.

Azure PowerShell

O Azure PowerShell pode ser usado para provisionar a taxa de transferência de dimensionamento automático em um banco de dados ou recursos em nível de contêiner para todas as APIs do Azure Cosmos DB. Para exemplos, confira Exemplos do Azure PowerShell para o Azure Cosmos DB.

Próximas etapas

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

Unidades de solicitação e taxa de transferência no Azure Cosmos DB
Tentando fazer um planejamento de capacidade para uma migração para o Microsoft Azure Cosmos DB? Você pode usar informações sobre o cluster de banco de dados existente para fazer isso.
- Se você sabe apenas o número de vCores e servidores no cluster de banco de dados existente, leia sobre como estimar unidades de solicitação com vCores ou vCPUs
- Se souber as taxas de solicitação típicas da carga de trabalho do banco de dados atual, leia sobre como estimar unidades de solicitação usando o planejador de capacidade do Azure Cosmos DB

Compartilhar via