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

  • Article

S’APPLIQUE À : Gremlin

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

Les en-têtes retournés par l’API Gremlin sont mappés aux attributs d’état personnalisés qui sont actuellement exposés par les Kits de développement logiciel (SDK) Java et .NET Gremlin. Les frais de demande sont disponibles sous la clé x-ms-request-charge. Lorsque vous utilisez l’API Gremlin, vous disposez de plusieurs options pour rechercher la consommation d’unités de requête pour une opération sur un conteneur Azure Cosmos.

Utilisation du portail Azure

  1. Connectez-vous au portail Azure.

  2. Créez un compte Azure Cosmos 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. Entrez une requête valide, puis sélectionnez Exécuter la requête Gremlin.

  5. Sélectionnez Statistiques des requêtes pour afficher les frais réels de la demande que vous avez exécutée.

Capture d’écran d’obtention des frais de requête Gremlin sur le portail Azure

Utiliser le pilote SDK .NET

Lorsque vous utilisez le Kit de développement logiciel (SDK) .NET Gremlin, les attributs d’état sont disponibles sous la propriété StatusAttributes de l’objet ResultSet<> :

ResultSet<dynamic> results = client.SubmitAsync<dynamic>("g.V().count()").Result;
double requestCharge = (double)results.StatusAttributes["x-ms-request-charge"];

Pour plus d’informations, consultez Démarrage rapide : Générer une application .NET Framework ou Core à l’aide d’un compte Azure Cosmos DB for Gremlin.

Utiliser le pilote de SDK Java

Lorsque vous utilisez le Kit de développement logiciel (SDK) Java Gremlin , vous pouvez récupérer les attributs d’état en appelant la méthode statusAttributes() sur l’objet ResultSet :

ResultSet results = client.submit("g.V().count()");
Double requestCharge = (Double)results.statusAttributes().get().get("x-ms-request-charge");

Pour plus d’informations, consultez Démarrage rapide : Générer une base de données de graphe dans Azure Cosmos DB à l’aide du Kit de développement logiciel (SDK) Java.

Étapes suivantes

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