$collStats - Amazon DocumentDB
Beispiel (MongoDB Shell)Codebeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

$collStats

Neu ab Version 4.0

Die $collStats Aggregationsphase in Amazon DocumentDB bietet Statistiken über die angegebene Sammlung, ähnlich dem db.collection.stats() Befehl in der MongoDB-Shell. In dieser Phase können Informationen über die Sammlung abgerufen werden, z. B. die Anzahl der Dokumente, die Gesamtgröße der Sammlung und verschiedene Leistungskennzahlen.

Parameter

  • latencyStats: (optional) Ein Dokument, das die Optionen für die Erfassung von Latenzstatistiken spezifiziert. Dieser Parameter wird in Amazon DocumentDB nicht unterstützt.

  • recordStats: (optional) Ein Dokument, das die Optionen für die Erfassung von Datensatzstatistiken festlegt. Dieser Parameter wird in Amazon DocumentDB nicht unterstützt.

  • queryExecStats: (optional) Ein Dokument, das die Optionen für die Erfassung von Statistiken zur Abfrageausführung spezifiziert. Dieser Parameter wird in Amazon DocumentDB nicht unterstützt.

Beispiel (MongoDB Shell)

Das folgende Beispiel zeigt, wie die $collStats Aggregationsphase verwendet wird, um Statistiken über eine test in der db Datenbank benannte Sammlung abzurufen.

Erstellen Sie Beispieldokumente

db.test.insertMany([
  { "name": "John", "age": 30 },
  { "name": "Jane", "age": 25 },
  { "name": "Bob", "age": 35 }
]);

Beispiel für eine Abfrage

db.test.aggregate([
  { $collStats: {} }
]);

Ausgabe

{
  "ns" : "db.test",
  "count" : 3,
  "size" : 87,
  "avgObjSize" : 29,
  "storageSize" : 40960,
  "capped" : false,
  "nindexes" : 1,
  "totalIndexSize" : 8192,
  "indexSizes" : {
    "_id_" : 8192
  },
  "collScans" : 0,
  "idxScans" : 0,
  "opCounter" : {
    "numDocsIns" : 3,
    "numDocsUpd" : 0,
    "numDocsDel" : 0
  },
  "cacheStats" : {
    "collBlksHit" : 0,
    "collBlksRead" : 0,
    "collHitRatio" : 0,
    "idxBlksHit" : 0,
    "idxBlksRead" : 0,
    "idxHitRatio" : 0
  },
  "lastReset" : "2023-04-11T12:00:00Z",
  "ok" : 1,
  "operationTime" : Timestamp(1681206000, 1)
}

Codebeispiele

Um ein Codebeispiel für die Verwendung des $collStats Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

Node.js

Hier ist ein Beispiel für die Verwendung der $collStats Aggregationsphase in einer Node.js -Anwendung mit dem offiziellen MongoDB Node.js -Treiber:

const { MongoClient } = require('mongodb');

async function runCollStatsExample() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('db');
  const collection = db.collection('test');

  const result = await collection.aggregate([
    { $collStats: {} }
  ]).toArray();

  console.log(result);

  await client.close();
}

runCollStatsExample();
Python

Hier ist ein Beispiel für die Verwendung der $collStats Aggregationsphase in einer Python-Anwendung mithilfe des PyMongo Treibers:

from pymongo import MongoClient

def run_coll_stats_example():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['db']
    collection = db['test']

    result = list(collection.aggregate([
        { '$collStats': {} }
    ]))

    print(result)

    client.close()

run_coll_stats_example()