dbStats (comando de base de datos)

Definición

dbStats

El dbStats El comando 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 gestionado 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:

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

Comportamiento

El tiempo necesario para ejecutar el comando depende del tamaño total de la base de datos. Dado que el comando debe acceder a todos los archivos de datos, 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 vistas en la base de datos.

dbStats.objects

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

dbStats.avgObjSize

Tamaño promedio de cada documento en bytes. Es el dataSize resultado de dividir entre el número de documentos. El argumento de escala no afecta el avgObjSize valor.

dbStats.dataSize

Tamaño total de los datos sin comprimir almacenados en la base de datos. El valor disminuye al dataSize 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 de la base de datos para el almacenamiento de documentos, incluido el espacio libre.

El valor no disminuye al eliminar o storageSize reducir documentos. Este valor puede ser menor que para bases de datos que utilizan dataSize 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 de la base de datos para el almacenamiento de documentos. El espacio libre de la base de datos se asigna 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 libre del índice.

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

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 de índice libre.

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 de la base de datos. El espacio libre de almacenamiento de la base de datos se asigna al índice, pero no contiene datos.

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

indexFreeStorageSize No incluye compilaciones de índices en curso.

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

Actualizado en las versiones 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 de disco asignado a documentos e índices en todas las colecciones de la base de datos. Incluye el espacio de almacenamiento utilizado y libre. Esta suma es storageSize de indexSize y.

dbStats.totalFreeStorageSize

Suma del espacio de almacenamiento libre asignado a documentos e índices en todas las colecciones de la base de datos. Esta suma es freeStorageSize indexFreeStorageSizey.

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

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

dbStats.scaleFactor

scale valor utilizado por el comando.

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

dbStats.fsUsedSize

Tamaño total de todo el espacio de disco en uso en el sistema de archivos donde MongoDB almacena 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 dbStats de.

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