Búsqueda del cargo de la unidad de solicitud en las operaciones que se ejecutan en Azure Cosmos DB for MongoDB

SE APLICA A: MongoDB

Azure Cosmos DB admite varias API, como SQL, MongoDB, Cassandra, Gremlin y Table. Cada API tiene su propio conjunto de operaciones de base de datos. Estas abarcan desde sencillas lecturas y escrituras de punto hasta consultas complejas. Cada operación de base de datos consume recursos del sistema en función de la complejidad de la operación.

Azure Cosmos DB se encarga de normalizar el costo de todas las operaciones de base de datos y se expresa en términos de unidades de solicitud (RU en su forma abreviada). La solicitud de cargos son las unidades de solicitud que consumen todas las operaciones de base de datos. Puede considerar que las unidades de solicitud son como una moneda de rendimiento, que resume los recursos del sistema, como CPU, IOPS y memoria, necesarios para realizar las operaciones de base de datos compatibles con Azure Cosmos DB. Con independencia de qué API utilice para interactuar con el contenedor de Azure Cosmos DB, los costos siempre se miden por RU. Si la operación de base de datos es una escritura, lectura puntual o consulta, los costos siempre se miden en RU. Para obtener más información, vea el artículo Unidades de solicitud y sus consideraciones.

En este artículo se presentan las distintas formas de buscar el consumo de unidades de solicitud (RU) de cualquier operación que se ejecuta en un contenedor de Azure Cosmos DB for MongoDB. Si usa una API diferente, consulte los artículos API para NoSQL, API para Cassandra, API para Gremlin y API para Table para buscar el cargo de las RU.

El cargo de RU se expone mediante un comando de base de datos personalizado llamado getLastRequestStatistics. El comando devuelve un documento que contiene el nombre de la última operación ejecutada, el cargo de la solicitud y su duración. Si usa Azure Cosmos DB for MongoDB, tiene varias opciones para recuperar el cargo de RU.

Uso de Azure Portal

1. Inicie sesión en Azure Portal.

2. Cree una cuenta de Azure Cosmos DB y suminístrele datos, o seleccione una cuenta existente que ya contenga datos.

3. Vaya al panel Data Explorer y seleccione el contenedor en el que quiere trabajar.

4. Seleccione ... junto al nombre del contenedor y, después, Nueva consulta.

5. Escriba una consulta válida y, luego, seleccione Ejecutar consulta.

6. Seleccione Query Stats (Estadísticas de consulta) para mostrar el cargo de solicitud real correspondiente a la solicitud que ha ejecutado. Este editor de consultas permite ejecutar y ver los cargos por unidad de solicitud solo para los predicados de consulta. No puede usar este editor para los comandos de manipulación de datos, como las instrucciones INSERT.

   

7. Para obtener los cargos por solicitud de los comandos de manipulación de datos, ejecute el comando getLastRequestStatistics desde una interfaz de usuario basada en Shell, como Mongo Shell, Robo 3T, MongoDB Compass o una extensión de Visual Studio Code con scripting de Shell.

   db.runCommand({getLastRequestStatistics: 1})

De manera programática

Shell de Mongo

Si se usa el shell de Mongo, se pueden ejecutar comandos mediante runCommand().

db.runCommand('getLastRequestStatistics')

Controlador de .NET

Al usar el controlador oficial de .NET para MongoDB, puede ejecutar comandos mediante una llamada al método RunCommand en un objeto IMongoDatabase. Este método requiere una implementación de la clase abstracta 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 más información, consulte Inicio rápido: Creación de una aplicación web .NET mediante el uso de una API de Azure Cosmos DB for MongoDB.

Controlador Java

Al usar el controlador oficial de Java para MongoDB, puede ejecutar comandos mediante una llamada al método runCommand en un objeto MongoDatabase:

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

Para más información, consulte Inicio rápido: Compilación de una aplicación web mediante la API de Azure Cosmos DB for MongoDB y el SDK de Java.

Controlador de Node.js

Al usar el controlador oficial de Node.js para MongoDB, puede ejecutar comandos mediante una llamada al método command en un objeto db:

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

Para más información, consulte Inicio rápido: Migración de una aplicación web actual de Node.js en MongoDB a Azure Cosmos DB.

Controlador de Python

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

Pasos siguientes

Para obtener información sobre cómo optimizar el consumo de RU, vea estos artículos:

• Rendimiento y unidades de solicitud en Azure Cosmos DB
• Optimización del costo de rendimiento aprovisionado en Azure Cosmos DB
• Optimización de los costos de consulta de Azure Cosmos DB
• ¿Intenta planear la capacidad de una migración a Azure Cosmos DB? Para ello, puede usar información sobre el clúster de bases de datos existente.
  • Si lo único que sabe es el número de núcleos virtuales y servidores del clúster de bases de datos existente, consulte la información sobre el cálculo de unidades de solicitud mediante núcleos virtuales o CPU virtuales.
  • Si conoce las tasas de solicitudes típicas de la carga de trabajo de la base de datos actual, obtenga información sobre el cálculo de unidades de solicitud mediante la herramienta de planeamiento de capacidad de Azure Cosmos DB.