Localizar o custo da unidade de pedido para as operações executadas no Azure Cosmos DB para MongoDB

APLICA-SE A: MongoDB

O Azure Cosmos DB suporta muitas APIs, como SQL, MongoDB, Cassandra, Gremlin e Table. Cada API tem o seu próprio conjunto de operações de base de dados. Estas operações vão desde leituras e escritas simples a consultas complexas. Cada operação de base de dados consome recursos do sistema com base na complexidade da operação.

O custo de todas as operações de bases de dados é regulado pelo Azure Cosmos DB e é expresso por Unidades de Pedido (ou RUs, abreviatura em inglês). O custo do pedido é as unidades de pedido consumidas por todas as operações da base de dados. Pode considerar as RUs como uma moeda de desempenho que abstrai os recursos do sistema, como CPU, IOPS e memória necessárias para realizar as operações de base de dados suportadas pelo Azure Cosmos DB. Independentemente da API que utiliza para interagir com o contentor do Azure Cosmos DB, os custos são sempre medidos pelas RUs. Quer a operação da base de dados seja uma consulta de escrita, leitura de ponto ou consulta, os custos são sempre medidos em RUs. Para saber mais, veja o artigo unidades de pedido e considerações .

Este artigo apresenta as diferentes formas de encontrar o consumo da unidade de pedido (RU) para qualquer operação executada num contentor no Azure Cosmos DB para MongoDB. Se estiver a utilizar uma API diferente, veja API para NoSQL, API para Cassandra, API para Gremlin e API para artigos de Tabela para localizar o custo de RU/s.

A carga de RU é exposta por um comando de base de dados personalizado com o nome getLastRequestStatistics. O comando devolve um documento que contém o nome da última operação executada, o respetivo custo de pedido e a respetiva duração. Se utilizar o Azure Cosmos DB para MongoDB, terá várias opções para obter o custo de RU.

Utilizar o portal do Azure

1. Inicie sessão no Portal do Azure.

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

3. Aceda ao painel Data Explorer e, em seguida, selecione o contentor no qual pretende trabalhar.

4. Selecione o ... junto ao nome do contentor e selecione Nova Consulta.

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

6. Selecione Estatísticas de Consulta para apresentar o custo real do pedido que executou. Este editor de consultas permite-lhe executar e ver os custos das unidades de pedidos apenas para predicados de consulta. Não pode utilizar este editor para comandos de manipulação de dados, como inserir instruções.

   

7. Para obter custos de pedidos para comandos de manipulação de dados, execute o comando a getLastRequestStatistics partir de uma IU baseada na shell, como a shell do Mongo, Robo 3T, MongoDB Compass ou uma extensão do VS Code com scripting de shell.

   db.runCommand({getLastRequestStatistics: 1})

Através de programação

Mongo Shell

Quando utiliza a shell do Mongo, pode executar comandos com runCommand().

db.runCommand('getLastRequestStatistics')

Controlador .NET

Quando utiliza o controlador .NET do MongoDB oficial, pode executar comandos ao chamar o RunCommand método num IMongoDatabase objeto. Este método requer uma implementação da Command<> classe abstrata:

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, veja Início Rápido: Criar uma aplicação Web .NET com um Azure Cosmos DB para MongoDB.

Controlador Java

Quando utiliza o controlador Java do MongoDB oficial, pode executar comandos ao chamar o runCommand método num MongoDatabase objeto:

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

Para obter mais informações, veja Início Rápido: Criar uma aplicação Web com o Azure Cosmos DB para MongoDB e o SDK Java.

Controlador Node.js

Quando utiliza o controlador de Node.js oficial do MongoDB, pode executar comandos ao chamar o command método num db objeto:

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

Para obter mais informações, veja Início Rápido: Migrar uma aplicação Web do MongoDB Node.js existente para o Azure Cosmos DB.

Controlador Python

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

Passos seguintes

Para saber mais sobre como otimizar o consumo de RUs, veja estes artigos:

• Unidades de pedido e débito no Azure Cosmos DB
• Otimizar o débito aprovisionado no Azure Cosmos DB
• Otimizar o custo das consultas no Azure Cosmos DB
• Está a tentar planear a capacidade de uma migração para o Azure Cosmos DB? Pode utilizar informações sobre o cluster de bases de dados existentes para o planeamento de capacidade.
  • Se tudo o que sabe for o número de vCores e servidores no cluster de bases de dados existentes, leia sobre a estimativa de unidades de pedido com vCores ou vCPUs
  • Se souber taxas de pedido típicas para a carga de trabalho atual da base de dados, leia sobre a estimativa de unidades de pedido com o planeador de capacidade do Azure Cosmos DB