Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

$collStats

Novedades de la versión 4.0

La etapa de $collStats agregación de Amazon DocumentDB proporciona estadísticas sobre la colección especificada, de forma similar al db.collection.stats() comando del shell de MongoDB. Esta etapa se puede utilizar para recuperar información sobre la recopilación, como la cantidad de documentos, el tamaño total de la colección y varias métricas de rendimiento.

Parámetros

Ejemplo (MongoDB Shell)

El siguiente ejemplo muestra cómo utilizar la etapa de $collStats agregación para recuperar estadísticas sobre una colección nombrada test en la db base de datos.

Cree documentos de muestra

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

Ejemplo de consulta

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

Salida

{
  "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)
}

Ejemplos de código

Para ver un ejemplo de código para usar el $collStats comando, elija la pestaña del idioma que desee usar:

Node.js

A continuación, se muestra un ejemplo de cómo utilizar la etapa de $collStats agregación en una aplicación de Node.js con el controlador Node.js oficial de MongoDB:

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

A continuación, se muestra un ejemplo de cómo utilizar la etapa de $collStats agregación en una aplicación de Python mediante el PyMongo controlador:

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()