dbStats (comando de base de datos)

Definición

dbStats

El comando dbStats devuelve estadísticas de almacenamiento para una base de datos determinada.

Compatibilidad

Este comando está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente administrado para implementaciones de MongoDB en la nube.

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     dbStats: 1,
     scale: <number>,
     freeStorage: 0
   }
)

Campos de comandos

El comando toma los siguientes campos:

En mongosh, la función db.stats() proporciona un contenedor alrededor de dbStats.

Comportamiento

El tiempo necesario para ejecutar el comando depende del tamaño total de la base de datos. Debido a que el comando debe acceder a todos los archivos de datos, el comando puede tardar varios segundos en ejecutarse.

Salida

dbStats.db

Nombre de la base de datos.

dbStats.collections

Número de colecciones en la base de datos.

dbStats.views

Número de visualizaciones en la base de datos.

dbStats.objects

Número de objetos (específicamente, documentos) en la base de datos de todas las colecciones.

dbStats.avgObjSize

Tamaño promedio de cada documento en bytes. Este valor es dataSize dividido por el número de documentos. El argumento scale no afecta el valor avgObjSize.

dbStats.dataSize

Tamaño total de los datos sin comprimir almacenados en la base de datos. El valor de dataSize disminuye al eliminar documentos.

Para bases de datos que utilicen el motor de almacenamiento WiredTiger, dataSize puede ser mayor que storageSize si la compresión está habilitada. El dataSize disminuye cuando los documentos se hacen más pequeños.

dbStats.storageSize

Suma del espacio en disco asignado a todas las colecciones en la base de datos para el almacenamiento de documentos, incluido el espacio libre.

El valor storageSize no disminuye al eliminar o reducir el tamaño de los documentos. Este valor puede ser menor que dataSize para bases de datos que utilizan el motor de almacenamiento WiredTiger con la compresión habilitada.

storageSize no incluye el espacio asignado a los índices. Consulte indexSize para conocer el tamaño total del índice.

dbStats.freeStorageSize

Suma del espacio libre asignado a todas las colecciones en la base de datos para el almacenamiento de documentos. Se asigna espacio de almacenamiento gratuito en la base de datos a la colección, pero no contiene datos.

freeStorageSize no incluye el espacio libre asignado a los índices. Consulte indexFreeStorageSize para conocer el tamaño total del índice libre.

Para incluir este valor en la salida dbStats, establezca freeStorage en 1.

Actualizado en la versión 5.3.0, 5.2.1 y 5.0.6

dbStats.indexes

Número total de índices en todas las colecciones de la base de datos.

dbStats.indexSize

Suma del espacio en disco asignado a todos los índices de la base de datos, incluido el espacio libre de índices.

Nota

En colecciones con índice clusterizado con solo un índice por defecto en el campo _ìd (sin índices secundarios), el tamaño del índice aparece como cero porque la colección no requiere un archivo de índice independiente.

dbStats.indexFreeStorageSize

Suma del espacio libre en disco asignado a todos los índices en la base de datos. El espacio de almacenamiento de base de datos gratuito se asigna al índice, pero no contiene datos.

indexFreeStorageSize no incluye el espacio libre asignado al almacenamiento de documentos. Consulte freeStorageSize para conocer el tamaño total del espacio libre de almacenamiento de documentos.

indexFreeStorageSize no incluye creaciones de índices en curso.

Para incluir este valor en la salida dbStats, establezca freeStorage en 1.

Actualizado en la versión 7.0, 6.3.2, 6.0.7, 5.3.0, 5.2.1, 5.0.19 y 5.0.6

dbStats.totalSize

Suma del espacio en disco asignado tanto para documentos como para índices en todas las colecciones de la base de datos. Incluye el espacio de almacenamiento utilizado y libre. Esta es la suma de storageSize y indexSize.

dbStats.totalFreeStorageSize

Suma del espacio de almacenamiento libre asignado tanto para documentos como para índices en todas las colecciones de la base de datos. Esta es la suma de freeStorageSize y indexFreeStorageSize.

Para incluir este valor en la salida dbStats, establezca freeStorage en 1.

Actualizado en la versión 5.3.0, 5.2.1 y 5.0.6.

dbStats.scaleFactor

scale valor utilizado por el comando.

Si se especifica un factor de escala no entero, MongoDB utiliza la parte entera del factor especificado. Por ejemplo, si se especifica un factor de escala de 1023.999, MongoDB utiliza 1023 como factor de escala.

dbStats.fsUsedSize

Tamaño total de todo el espacio en disco en uso en el sistema de archivos donde MongoDB almacena los datos.

Tip

--dbpath

dbStats.fsTotalSize

Tamaño total de toda la capacidad del disco en el sistema de archivos donde MongoDB almacena datos.

Ejemplos

Los siguientes ejemplos demuestran el uso de dbStats.

db.runCommand( { dbStats: 1 } ).indexSize

db.runCommand( { dbStats: 1, scale: 1024, freeStorage: 1 } )

{
  db: 'test',
  collections: 2,
  views: 0,
  objects: 1689,
  avgObjSize: 52.56542332741267,
  dataSize: 86.7021484375,
  storageSize: 100,
  freeStorageSize: 32,
  indexes: 2,
  indexSize: 116,
  indexFreeStorageSize: 36,
  totalSize: 216,
  totalFreeStorageSize: 68,
  scaleFactor: 1024,
  fsUsedSize: 60155820,
  fsTotalSize: 61255492,
  ok: 1,
  '$clusterTime': {
    clusterTime: Timestamp({ t: 1646085664, i: 1 }),
    signature: {
      hash: Binary(Buffer.from("0000000000000000000000000000000000000000", "hex"), 0),
      keyId: Long("0")
    }
  },
  operationTime: Timestamp({ t: 1646085664, i: 1 })
}