Localizar o encargo de unidade de solicitação para operações executadas no Azure Cosmos DB for MongoDB

APLICA-SE AO: MongoDB

O Azure Cosmos DB dá suporte a muitas APIs como SQL, MongoDB, Cassandra, Gremlin e Table. Cada API tem seu próprio conjunto de operações de banco de dados. Essas operações variam de simples leituras e gravações de pontos a consultas complexas. Cada operação de banco de dados consome recursos do sistema com base na complexidade da operação.

O custo de todas as operações do banco de dados é normalizado pelo Azure Cosmos DB e expresso por Unidades de Solicitação (ou RUs, abreviado na sigla em inglês). O preço da solicitação corresponde às unidades de solicitação consumidas por todas as operações de banco de dados. Você pode encarar as RUs como uma moeda de desempenho que abstrai os recursos do sistema (como CPU, IOPS e memória) necessários para executar as operações de banco de dados compatíveis com o Azure Cosmos DB. Independentemente da API usada para interagir com o contêiner do Azure Cosmos DB, os custos sempre serão medidos por RUs. Independentemente da operação de banco de dados ser uma gravação, uma leitura pontual ou uma consulta, os custos serão sempre medidos em RUs. Para saber mais, confira o artigo As unidades de solicitação e considerações sobre elas.

Este artigo apresenta as diferentes maneiras pelas quais você pode encontrar o consumo da unidade de solicitação (RU) para qualquer operação executada em um contêiner no Azure Cosmos DB for MongoDB. Se você estiver usando uma API diferente, confira os artigos API para o NoSQL, API para Cassandra, API para Gremlin e API para Table para localizar o preço de RUs.

O preço de RU é exposto por um comando de banco de dados personalizado chamado getLastRequestStatistics. O comando retorna um documento que contém o nome da última operação executada, seu preço de solicitação e sua duração. Se você usar o Azure Cosmos DB for MongoDB, você terá várias opções para recuperar o preço de RU.

Use o Portal do Azure

1. Entre no portal do Azure.

2. Crie uma conta do Azure Cosmos DB e alimente-a com alguns dados ou selecione uma conta existente que já contenha dados.

3. Acesse o painel do Data Explorer e, em seguida, selecione o contêiner no qual deseja trabalhar.

4. Selecione … ao lado do nome do contêiner e selecione Nova consulta.

5. Insira uma consulta válida e, em seguida, selecione Executar Consulta.

6. Selecione Estatísticas da Consulta para exibir o preço de solicitação real da solicitação executada. Esse editor de consultas permite executar e exibir encargos de unidade de solicitação somente para predicados de consulta. Você não pode usar esse editor para comandos de manipulação de dados, como instruções de inserção.

   

7. Para obter encargos de solicitação para comandos de manipulação de dados, execute o comando getLastRequestStatistics de uma interface do usuário baseada em Shell, como Mongo Shell, Robo 3T, MongoDB Compass ou uma extensão VS Code com script de Shell.

   db.runCommand({getLastRequestStatistics: 1})

Programaticamente

Mongo Shell

Ao usar o Mongo Shell, você pode executar comandos usando runCommand().

db.runCommand('getLastRequestStatistics')

Driver .NET

Ao usar o driver oficial do .NET do MongoDB, você pode executar comandos chamando o método RunCommand em um objeto IMongoDatabase. Esse método exige uma implementação da classe abstrata Command<>:

class GetLastRequestStatisticsCommand : Command<Dictionary<string, object>>
{
    public override RenderedCommand<Dictionary<string, object>> Render(IBsonSerializerRegistry serializerRegistry)
    {
        return new RenderedCommand<Dictionary<string, object>>(new BsonDocument("getLastRequestStatistics", 1), serializerRegistry.GetSerializer<Dictionary<string, object>>());
    }
}

Dictionary<string, object> stats = database.RunCommand(new GetLastRequestStatisticsCommand());
double requestCharge = (double)stats["RequestCharge"];

Para obter mais informações, confira Início rápido: criar um aplicativo Web do .NET usando uma conta do Azure Cosmos DB for MongoDB.

Driver Java

Ao usar o driver oficial do Java do MongoDB, você pode executar comandos chamando o método runCommand em um objeto MongoDatabase:

Document stats = database.runCommand(new Document("getLastRequestStatistics", 1));
Double requestCharge = stats.getDouble("RequestCharge");

Para obter mais informações, confira Início rápido: criar um aplicativo Web usando o Azure Cosmos DB for MongoDB e SDK do Java.

Driver Node.js

Ao usar o driver oficial do Node.js do MongoDB, você pode executar comandos chamando o método command em um objeto db:

db.command({ getLastRequestStatistics: 1 }, function(err, result) {
    assert.equal(err, null);
    const requestCharge = result['RequestCharge'];
});

Para mais informações, consulte Início rápido: migre um aplicativo Web Node.js do MongoDB existente para o Azure Cosmos DB.

Driver Python

response = db.command('getLastRequestStatistics')
requestCharge = response['RequestCharge']

Próximas etapas

Para saber mais sobre como otimizar o consumo de RU, confira estes artigos:

• Unidades de solicitação e taxa de transferência no Azure Cosmos DB
• Otimizar a taxa de transferência provisionada no Azure Cosmos DB
• Otimizar o custo de consulta no Azure Cosmos DB
• Você está tentando fazer um planejamento da capacidade para uma migração para o 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 do 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