Hitta kostnaden för enhet för programbegäran för åtgärder som körs i Azure Cosmos DB för Apache Cassandra

GÄLLER FÖR: Cassandra

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). Kostnaden för begäran är de enheter för programbegäran som förbrukas av alla dina databasåtgärder. Du kan betrakta RU:er som en prestandavaluta som abstraherar systemresurser som CPU, IOPS och minne som krävs för att utföra de 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 enheter för programbegäran 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 artiklarna API for MongoDB, API for NoSQL, API for Gremlin och API for Table 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 på 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 för 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:

• Begärandeenheter 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