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

S’APPLIQUE À : Cassandra

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 (RU) pour toute opération exécutée sur un conteneur dans Azure Cosmos DB for Apache Cassandra. Si vous utilisez une autre API, consultez les articles API pour MongoDB, API pour NoSQL, API pour Gremlin et API pour Table pour trouver les frais en lien avec les RU/s.

Quand vous effectuez des opérations sur Azure Cosmos DB for Apache Cassandra, les frais d’unités de requête sont retournés dans la charge utile entrante sous la forme d’un champ nommé RequestCharge. Vous disposez de plusieurs options pour récupérer les frais d’unités de requête.

Utiliser un pilote Cassandra

Pilote .NET

Lorsque vous utilisez le Kit de développement logiciel (SDK) .NET, vous pouvez récupérer la charge utile entrante sous la propriété Info d’un objet RowSet :

RowSet rowSet = session.Execute("SELECT table_name FROM system_schema.tables;");
double requestCharge = BitConverter.ToDouble(rowSet.Info.IncomingPayload["RequestCharge"].Reverse().ToArray(), 0);

Pour plus d’informations, consultez Démarrage rapide : Générer une application Cassandra à l’aide du Kit de développement logiciel (SDK) .NET et d’Azure Cosmos DB.

Pilote Java

Lorsque vous utilisez le Kit de développement logiciel (SDK) Java, vous pouvez récupérer la charge utile entrante en appelant la méthode getExecutionInfo() sur un objet ResultSet :

ResultSet resultSet = session.execute("SELECT table_name FROM system_schema.tables;");
Double requestCharge = resultSet.getExecutionInfo().getIncomingPayload().get("RequestCharge").getDouble();

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

Pilote GOCQL

Lorsque vous utilisez le pilote GOCQL, vous pouvez récupérer la charge utile entrante en appelant la méthode GetCustomPayload() sur un type Iter :

query := session.Query(fmt.Sprintf("SELECT * FROM <keyspace.table> where <value> = ?", keyspace, table)).Bind(<value>)
iter := query.Iter()
requestCharge := iter.GetCustomPayload()["RequestCharge"]
requestChargeBits := binary.BigEndian.Uint64(requestCharge)
requestChargeValue := math.Float64frombits(requestChargeBits)
fmt.Printf("%v\n", requestChargeValue)

Pour plus d’informations, consultez Démarrage rapide : Générer une application Cassandra avec le pilote GOCQL 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 :

• 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