Encontre a taxa de unidade de solicitação para operações executadas no Azure Cosmos DB para MongoDB

APLICA-SE A: 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 pontuais 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 de bases de dados é regulado pelo Azure Cosmos DB e é expresso por Unidades de Pedido (ou RUs, abreviatura em inglês). A taxa de solicitação é a unidade de solicitação consumida por todas as operações do banco de dados. Você pode pensar em RUs como uma moeda de desempenho abstraindo os recursos do sistema, como CPU, IOPS e memória, necessários para executar as operações de banco de dados com suporte do Azure Cosmos DB. Não interessa que API utiliza para interagir com o contentor do Azure Cosmos DB: os custos são sempre medidos por RUs. Seja a operação da base de dados de escrita, de leitura de ponto ou de consulta, os custos são sempre medidos em RU. Para saber mais, consulte as unidades de solicitação e seu artigo de considerações .

Este artigo apresenta as diferentes maneiras de encontrar o consumo de unidade de solicitação (RU) para qualquer operação executada em um contêiner no Azure Cosmos DB para MongoDB. Se você estiver usando uma API diferente, consulte API para NoSQL, API para Cassandra, API para Gremlin e API para artigos de tabela para encontrar a cobrança de RU/s.

A carga RU é exposta 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, sua carga de solicitação e sua duração. Se você usar o Azure Cosmos DB para MongoDB, terá várias opções para recuperar a cobrança 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. Vá para o painel Data Explorer e selecione o contêiner no qual deseja trabalhar.

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

5. Insira uma consulta válida e selecione Executar consulta.

6. Selecione Estatísticas de consulta para exibir a cobrança de solicitação real para a solicitação executada. Este editor de consultas permite que você execute e visualize cobranças de unidade de solicitação apenas para predicados de consulta. Não é possível usar este editor para comandos de manipulação de dados, como instruções insert.

   

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

   db.runCommand({getLastRequestStatistics: 1})

Através de programação

Concha Mongo

Quando você usa o shell Mongo, você pode executar comandos usando runCommand().

db.runCommand('getLastRequestStatistics')

Driver .NET

Quando você usa o driver .NET oficial do MongoDB, você pode executar comandos chamando o RunCommand método em um 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, consulte Guia de início rápido: criar um aplicativo Web .NET usando um Azure Cosmos DB para MongoDB.

Driver Java

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

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

Para obter mais informações, consulte Guia de início rápido: criar um aplicativo Web usando o Azure Cosmos DB para MongoDB e o Java SDK.

Node.js motorista

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

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

Para obter mais informações, consulte Guia de início rápido: migrar um aplicativo Web MongoDB Node.js existente para o Azure Cosmos DB.

Driver Python

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

Próximos passos

Para saber mais sobre como otimizar seu consumo de RU, consulte 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
• Tentando fazer o planejamento de capacidade para uma migração para o Azure Cosmos DB? Você pode usar informações sobre seu cluster de banco de dados existente para planejamento de capacidade.
  • Se tudo o que você sabe é o número de vCores e servidores em seu cluster de banco de dados existente, leia sobre como estimar unidades de solicitação usando vCores ou vCPUs
  • Se você souber as taxas de solicitação típicas para sua carga de trabalho de banco de dados atual, leia sobre como estimar unidades de solicitação usando o planejador de capacidade do Azure Cosmos DB