Trovare l'addebito delle unità richiesta per le operazioni eseguite in Azure Cosmos DB for MongoDB

SI APPLICA A: MongoDB

Azure Cosmos DB supporta un'ampia gamma di API, come SQL, MongoDB, Cassandra, Gremlin e Tabella. Ogni API ha il proprio set di operazioni di database, da semplici operazioni di lettura e scrittura puntuali a query complesse. Ogni operazione di database utilizza le risorse di sistema a seconda della complessità.

Il costo di tutte le operazioni di database viene normalizzato da Azure Cosmos DB ed è espresso in termini di unità richiesta (o in breve UR). L'addebito delle richieste è costituito dalle unità richiesta utilizzate da tutte le operazioni del database. Un'unità richiesta si può considerare come una valuta basata sulle prestazioni determinata in base all'astrazione delle risorse di sistema, ad esempio CPU, operazioni di I/O al secondo e memoria, necessarie per eseguire le operazioni di database supportate da Azure Cosmos DB. I costi vengono sempre misurati in UR, indipendentemente dall'API usata per interagire con il contenitore di Azure Cosmos DB. Sia che l'operazione di database sia una scrittura, una lettura di punti o una query, i costi sono sempre misurati in UR. Per altre informazioni, vedere l'articolo sulle unità richiesta e sulle relative considerazioni.

Questo articolo presenta i vari modi in cui è possibile trovare il consumo di unità richiesta (UR) per qualsiasi operazione eseguita su un contenitore in Azure Cosmos DB for MongoDB. Se si usa un'API diversa, vedere gli articoli sull'API per NoSQL, l'API per Cassandra, l'API per Gremlin e l'API per Table per trovare l'addebito delle UR/sec.

L'addebito delle UR è esposto da un comando di database personalizzato denominato getLastRequestStatistics. Il comando restituisce un documento contenente il nome dell'ultima operazione eseguita, il relativo addebito della richiesta e la durata. Se si usa l'API Azure Cosmos DB for MongoDB, sono disponibili diverse opzioni per il recupero dell'addebito delle UR.

Usare il portale di Azure

1. Accedere al portale di Azure.

2. Creare un nuovo account Azure Cosmos DB e inserirvi dati oppure selezionare un account esistente che contiene già dati.

3. Passare al riquadro Esplora dati e quindi selezionare il contenitore da usare.

4. Selezionare i punti di sospensione (...) accanto al nome del contenitore e selezionare Nuova query.

5. Immettere una query valida e quindi fare clic su Esegui query.

6. Fare clic su Statistiche query per visualizzare l'addebito effettivo per la richiesta eseguita. Questo editor di query consente di eseguire e visualizzare gli addebiti delle unità richiesta solo per i predicati di query. Non è possibile usare l'editor per i comandi di modifica dei dati, ad esempio le istruzioni insert.

   

7. Per ottenere gli addebiti delle richieste per i comandi di modifica dei dati, eseguire il comando getLastRequestStatistics da un'interfaccia utente basata su shell come Mongo Shell, Robo 3T, MongoDB Compasso un'estensione di VS Code con script della shell.

   db.runCommand({getLastRequestStatistics: 1})

A livello di codice

Mongo Shell

Quando si usa la shell Mongo, è possibile eseguire comandi usando runCommand().

db.runCommand('getLastRequestStatistics')

Driver .NET

Quando si usa il driver .NET MongoDB ufficiale, è possibile eseguire i comandi chiamando il metodo RunCommand per un oggetto IMongoDatabase. Questo metodo richiede un'implementazione della classe astratta Command<>:

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"];

Per altre informazioni, vedere Avvio rapido: Creare un'app Web .NET usando un'API Azure Cosmos DB for MongoDB.

Driver Java

Quando si usa il driver Java MongoDB ufficiale, è possibile eseguire i comandi chiamando il metodo runCommand per un oggetto MongoDatabase:

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

Per altre informazioni, vedere Avvio rapido: Creare un'app Web usando Azure Cosmos DB for MongoDB e Java SDK.

Driver Node.js

Quando si usa il driver Node.js MongoDB ufficiale, è possibile eseguire i comandi chiamando il metodo command per un oggetto db:

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

Per altre informazioni, vedere Avvio rapido: Eseguire la migrazione di un'app Web Node.js MongoDB esistente ad Azure Cosmos DB.

Driver Python

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

Passaggi successivi

Per informazioni su come ottimizzare il consumo di UR, vedere questi articoli:

• Velocità effettiva e unità richiesta in Azure Cosmos DB
• Ottimizzare il costo della velocità effettiva con provisioning in Azure Cosmos DB
• Ottimizzare il costo delle query in Azure Cosmos DB
• Si sta tentando di pianificare la capacità per una migrazione ad Azure Cosmos DB? È possibile usare le informazioni del cluster di database esistente per la pianificazione della capacità.
  • Se si conosce solo il numero di vCore e server nel cluster di database esistente, leggere le informazioni sulla stima delle unità richieste con vCore o vCPU
  • Se si conosce la frequenza delle richieste tipiche per il carico di lavoro corrente del database, leggere le informazioni sulla stima delle unità richieste con lo strumento di pianificazione della capacità di Azure Cosmos DB