Rechercher les frais des unités de requête pour les opérations exécutées dans Azure Cosmos DB for MongoDB

S’APPLIQUE À : MongoDB

Azure Cosmos DB prend en charge de nombreuses API, notamment SQL, MongoDB, Cassandra, Gremlin et Table. Chaque API possède son propre ensemble d’opérations de base de données, qui vont de simples opérations ponctuelles de lecture et d'écriture à des requêtes complexes. Chaque opération de base de données consomme des ressources système en fonction de sa complexité.

Le coût de toutes les opérations de base de données, normalisé par Azure Cosmos DB, est exprimé en unités de requête (RU). Les frais de requête sont les unités de requête consommées par toutes vos opérations de base de données. Les RU correspondent en quelque sorte à une devise de performances, faisant abstraction des ressources système (UC, IOPS, mémoire, etc.) requises pour effectuer les opérations de base de données prises en charge par Azure Cosmos DB. Quelle que soit l’API utilisée pour interagir avec le conteneur Azure Cosmos DB, les coûts sont toujours mesurés en unités de requête. Que l’opération de base de données soit une opération d’écriture, de lecture de point ou de requête, les coûts sont toujours mesurés en unités de requête. Pour plus d’informations, consultez l’article Unités de requête et considérations.

Cet article présente les différentes façons de rechercher la consommation d’unités de requête pour toute opération exécutée sur un conteneur dans Azure Cosmos DB for MongoDB. Si vous utilisez une autre API, consultez les articles API pour NoSQL, API pour Cassandra, API pour Gremlin et API pour Table pour trouver les frais en lien avec les unités de requête/s.

Les frais d’unités de requête sont exposés par une commande de base de données personnalisée nommée getLastRequestStatistics. Cette commande retourne un document contenant le nom de la dernière opération exécutée, ses frais de demande et sa durée. Si vous utilisez Azure Cosmos DB for MongoDB, vous disposez de plusieurs options pour récupérer les frais d’unités de requête.

Utilisation du portail Azure

1. Connectez-vous au portail Azure.

2. Créez un compte Azure Cosmos DB et remplissez-le avec des données, ou sélectionnez un compte existant qui contient déjà des données.

3. Accédez au volet Explorateur de données, puis sélectionnez le conteneur sur lequel vous voulez travailler.

4. Sélectionnez les points de suspension ( ... ) en regard du nom du conteneur, puis choisissez Nouvelle requête.

5. Entrez une requête valide, puis sélectionnez Exécuter la requête.

6. Sélectionnez Statistiques des requêtes pour afficher les frais réels de la demande que vous avez exécutée. Cet éditeur de requête vous permet d’exécuter et d’afficher les frais d’unité de demande uniquement pour les prédicats de requête. Vous ne pouvez pas utiliser cet éditeur pour des commandes de manipulation de données telles que les instructions insert.

   

7. Pour obtenir les frais de demande pour des commandes de manipulation de données, exécutez la commande getLastRequestStatistics à partir d’une interface utilisateur basée sur un interpréteur de commandes, tel que l’interpréteur de commandes Mongo, Robo 3T, MongoDB Compass ou une extension VS Code avec des scripts d’interpréteur de commandes.

   db.runCommand({getLastRequestStatistics: 1})

Par programmation

Interpréteur de commandes Mongo

Quand vous utilisez l’interpréteur de commandes Mongo, vous pouvez exécuter des commandes à l’aide de runCommand().

db.runCommand('getLastRequestStatistics')

Pilote .NET

Lorsque vous utilisez le pilote .NET MongoDB officiel, vous pouvez exécuter des commandes en appelant la méthode RunCommand sur un objet IMongoDatabase. Cette méthode nécessite une implémentation de la classe abstraite 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"];

Pour plus d’informations, consultez Démarrage rapide : Générer une application web .NET à l’aide d’Azure Cosmos DB for MongoDB.

Pilote Java

Lorsque vous utilisez le pilote Java MongoDB officiel, vous pouvez exécuter des commandes en appelant la méthode runCommand sur un objet MongoDatabase :

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

Pour plus d’informations, consultez Démarrage rapide : Générer une application web à l’aide d’Azure Cosmos DB for MongoDB et Java SDK.

Pilote Node.js

Lorsque vous utilisez le pilote Node.js MongoDB officiel, vous pouvez exécuter des commandes en appelant la méthode command sur un objet db :

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

Pour plus d’informations, consultez Démarrage rapide : Migrer une application web Node.js MongoDB existante vers Azure Cosmos DB.

Pilote Python

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

Étapes suivantes

Pour en savoir plus sur l’optimisation de votre consommation d’unités de requête, consultez les articles suivants :

• Unités de requête et débit dans Azure Cosmos DB
• Optimiser le coût du débit approvisionné dans Azure Cosmos DB
• Optimiser le coût de requête dans Azure Cosmos DB
• Vous tentez d’effectuer une planification de la capacité pour une migration vers Azure Cosmos DB ? Vous pouvez utiliser les informations sur votre cluster de bases de données existant pour la planification de la capacité.
  • Si vous ne connaissez que le nombre de vCore et de serveurs présents dans votre cluster de bases de données existant, lisez Estimation des unités de requête à l’aide de vCore ou de processeurs virtuels.
  • Si vous connaissez les taux de requêtes typiques de votre charge de travail de base de données actuelle, lisez la section concernant l’estimation des unités de requête à l’aide du planificateur de capacité Azure Cosmos DB