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

  • Article

S’APPLIQUE À : Table

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 Table. Si vous utilisez une autre API, consultez les articles API pour MongoDB, API pour Cassandra, API pour Gremlin et API pour NoSQL pour trouver les frais en lien avec les RU/s.

Utiliser le kit de développement logiciel (SDK) .NET

Actuellement, le seul Kit de développement logiciel (SDK) qui retourne les frais d’unités de requête pour les opérations de table est le Kit de développement .NET Standard. L’objet TableResult expose une propriété RequestCharge qui est renseignée par le SDK quand vous l’utilisez sur Azure Cosmos DB for Table :

CloudTable tableReference = client.GetTableReference("table");
TableResult tableResult = tableReference.Execute(TableOperation.Insert(new DynamicTableEntity("partitionKey", "rowKey")));
if (tableResult.RequestCharge.HasValue) // would be false when using Azure Storage Tables
{
    double requestCharge = tableResult.RequestCharge.Value;
}

Pour plus d’informations, consultez Démarrage rapide : Générer une application API pour Table avec le Kit de développement logiciel (SDK) .NET et Azure Cosmos DB.

Étapes suivantes

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