Hitta enhetsavgiften för begäranden för åtgärder som körs i Azure Cosmos DB för Apache Cassandra

GÄLLER FÖR: Kassandra

Azure Cosmos DB stöder många API:er, till exempel SQL, MongoDB, Cassandra, Gremlin och Table. Varje API har en egen uppsättning databasåtgärder. Dessa åtgärder sträcker sig från enkla punktläsningar och skrivningar till komplexa frågor. Varje databasåtgärd förbrukar systemresurser baserat på åtgärdens komplexitet.

Kostnaden för alla databasåtgärder normaliseras av Azure Cosmos DB och uttrycks i form av enheter för programbegäran (Request Units, RU:er). Begärandeavgiften är de enheter för begäran som förbrukas av alla dina databasåtgärder. Du kan se RU:er som en prestandavaluta som abstraherar systemresurser som CPU, IOPS och minne som krävs för att utföra databasåtgärder som stöds av Azure Cosmos DB. Oavsett vilket API du använder för att interagera med din Azure Cosmos DB-container mäts kostnaderna alltid med RU:er. Oavsett om databasåtgärden är en skrivning, punktläsning eller fråga mäts kostnaderna alltid i RU:er. Mer information finns i artikeln om enheter för begäranden och dess överväganden .

I den här artikeln beskrivs olika sätt att hitta ru-förbrukningen (request unit ) för alla åtgärder som körs mot en container i Azure Cosmos DB för Apache Cassandra. Om du använder ett annat API kan du läsa API för MongoDB, API för NoSQL, API för Gremlin och API för tabellartiklar för att hitta RU/s-avgiften.

När du utför åtgärder mot Azure Cosmos DB för Apache Cassandra returneras RU-avgiften i den inkommande nyttolasten som ett fält med namnet RequestCharge. Du har flera alternativ för att hämta RU-avgiften.

Använda en Cassandra-drivrutin

.NET-drivrutin

När du använder .NET SDK kan du hämta den inkommande nyttolasten under Info egenskapen för ett RowSet objekt:

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

Mer information finns i Snabbstart: Skapa en Cassandra-app med hjälp av .NET SDK och Azure Cosmos DB.

Java-drivrutin

När du använder Java SDK kan du hämta den inkommande nyttolasten genom att anropa getExecutionInfo() metoden för ett ResultSet objekt:

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

Mer information finns i Snabbstart: Skapa en Cassandra-app med hjälp av Java SDK och Azure Cosmos DB.

GOCQL-drivrutin

När du använder GOCQL-drivrutinen kan du hämta den inkommande nyttolasten genom att anropa GetCustomPayload() metoden på en Iter typ:

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)

Mer information finns i Snabbstart: Skapa en Cassandra-app med hjälp av GOCQL och Azure Cosmos DB.

Nästa steg

Mer information om hur du optimerar RU-förbrukningen finns i följande artiklar:

• Enheter för programbegäran och dataflöde i Azure Cosmos DB
• Optimera kostnaden för etablerat dataflöde i Azure Cosmos DB
• Optimera kostnaden för frågor i Azure Cosmos DB