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

GÄLLER FÖR: MongoDB

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 MongoDB. Om du använder ett annat API kan du läsa API för NoSQL, API för Cassandra, API för Gremlin och API för tabellartiklar för att hitta RU/s-avgiften.

RU-avgiften exponeras av ett anpassat databaskommando med namnet getLastRequestStatistics. Kommandot returnerar ett dokument som innehåller namnet på den senaste åtgärden som kördes, dess avgift för begäran och dess varaktighet. Om du använder Azure Cosmos DB för MongoDB har du flera alternativ för att hämta RU-avgiften.

Använda Azure Portal

1. Logga in på Azure-portalen.

2. Skapa ett nytt Azure Cosmos DB-konto och mata det med data, eller välj ett befintligt konto som redan innehåller data.

3. Gå till fönstret Datautforskaren och välj sedan den container som du vill arbeta med.

4. Välj ... bredvid containernamnet och välj Ny fråga.

5. Ange en giltig fråga och välj sedan Kör fråga.

6. Välj Frågestatistik för att visa den faktiska begärandeavgiften för den begäran som du körde. Med den här frågeredigeraren kan du köra och visa enhetsavgifter för begäranden endast för frågepredikat. Du kan inte använda den här redigeraren för datamanipuleringskommandon som insert-instruktioner.

   

7. Om du vill hämta avgifter för datamanipuleringskommandon kör getLastRequestStatistics du kommandot från ett gränssnittsbaserat användargränssnitt, till exempel Mongo Shell, Robo 3T, MongoDB Compass eller ett VS Code-tillägg med shell-skript.

   db.runCommand({getLastRequestStatistics: 1})

Programmässigt

Mongo Shell

När du använder Mongo-gränssnittet kan du köra kommandon med hjälp av runCommand().

db.runCommand('getLastRequestStatistics')

.NET-drivrutin

När du använder den officiella MongoDB .NET-drivrutinen kan du köra kommandon genom att anropa RunCommand metoden på ett IMongoDatabase objekt. Den här metoden kräver en implementering av den Command<> abstrakta klassen:

class GetLastRequestStatisticsCommand : Command<Dictionary<string, object>>
{
    public override RenderedCommand<Dictionary<string, object>> Render(IBsonSerializerRegistry serializerRegistry)
    {
        return new RenderedCommand<Dictionary<string, object>>(new BsonDocument("getLastRequestStatistics", 1), serializerRegistry.GetSerializer<Dictionary<string, object>>());
    }
}

Dictionary<string, object> stats = database.RunCommand(new GetLastRequestStatisticsCommand());
double requestCharge = (double)stats["RequestCharge"];

Mer information finns i Snabbstart: Skapa en .NET-webbapp med hjälp av en Azure Cosmos DB för MongoDB.

Java-drivrutin

När du använder den officiella MongoDB Java-drivrutinen kan du köra kommandon genom att anropa runCommand metoden på ett MongoDatabase objekt:

Document stats = database.runCommand(new Document("getLastRequestStatistics", 1));
Double requestCharge = stats.getDouble("RequestCharge");

Mer information finns i Snabbstart: Skapa en webbapp med hjälp av Azure Cosmos DB för MongoDB och Java SDK.

Node.js drivrutin

När du använder den officiella MongoDB-Node.js drivrutinen kan du köra kommandon genom att anropa command metoden på ett db objekt:

db.command({ getLastRequestStatistics: 1 }, function(err, result) {
    assert.equal(err, null);
    const requestCharge = result['RequestCharge'];
});

Mer information finns i Snabbstart: Migrera en befintlig MongoDB-Node.js webbapp till Azure Cosmos DB.

Python-drivrutin

response = db.command('getLastRequestStatistics')
requestCharge = response['RequestCharge']

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
• Försöker du planera kapacitet för en migrering till Azure Cosmos DB? Du kan använda information om ditt befintliga databaskluster för kapacitetsplanering.
  • Om allt du vet är antalet virtuella kärnor och servrar i ditt befintliga databaskluster läser du om att uppskatta enheter för begäranden med virtuella kärnor eller virtuella kärnor
  • Om du känner till vanliga begärandefrekvenser för din aktuella databasarbetsbelastning kan du läsa om att uppskatta enheter för begäranden med azure Cosmos DB-kapacitetshanteraren