dbStats (comando de banco de dados)

Definição

dbStats

O dbStats comando retorna estatísticas de armazenamento para determinado banco de dados.

Compatibilidade

Esse comando está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Sintaxe

O comando tem a seguinte sintaxe:

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

Campos de comando

O comando utiliza os seguintes campos:

mongoshEm, a função fornece um wrapper em db.stats() torno dbStats de.

Comportamento

O tempo necessário para executar o comando depende do tamanho total do banco de dados. Como o comando deve tocar em todos os arquivos de dados, o comando pode levar alguns segundos para ser executado.

Saída

dbStats.db

Nome do banco de dados.

dbStats.collections

Número de collections no banco de dados.

dbStats.views

Número de visualizações no banco de dados.

dbStats.objects

Número de objetos (especificamente, documentos) no banco de dados em todas as collections.

dbStats.avgObjSize

Tamanho médio de cada documento em bytes. Este é o dividido pelo dataSize número de documentos. O argumento de escala não afeta o avgObjSize valor.

dbStats.dataSize

Tamanho total dos dados não comprimidos mantidos no banco de dados. O diminui quando você dataSize remove documentos.

Para bancos de dados utilizando o mecanismo de armazenamento WiredTiger, o dataSize pode ser maior que storageSize se a compressão estiver habilitada. O dataSize diminui quando os documentos diminuem.

dbStats.storageSize

Soma do espaço em disco alocado a todas as collections no banco de dados para armazenamento de documentos, incluindo o espaço livre.

O storageSize não diminui à medida que você remove ou reduz documentos. Esse valor pode ser menor que para bancos de dados que usam dataSize o mecanismo de armazenamento WiredTiger com a compactação ativada.

storageSize não inclui espaço alocado para índices. Consulte para o tamanho total do indexSize índice.

dbStats.freeStorageSize

Soma do espaço livre alocado a todas as collections no banco de dados para armazenamento de documentos. O espaço de armazenamento do banco de dados livre é alocado para a collection, mas não contém dados.

freeStorageSize não inclui espaço livre alocado para índices. Consulte para obter o tamanho total do índice indexFreeStorageSize livre.

Para incluir esse valor na saída,dbStats defina freeStorage 1como.

Atualizado na versão 5.3.0, 5.2.1 e 5.0.6

dbStats.indexes

Número total de índices em todas as collections no banco de dados.

dbStats.indexSize

Soma do espaço em disco alocado a todos os índices no banco de dados, incluindo espaço de índice livre.

Observação

Em coletas agrupadas com somente um índice padrão no campo _ìd (sem índices secundários), o tamanho do índice aparece como zero porque a coleta não exige um arquivo de índice separado.

dbStats.indexFreeStorageSize

Soma do espaço livre em disco alocado para todos os índices no banco de dados. O espaço de armazenamento gratuito do banco de dados é alocado para o índice, mas não contém dados.

indexFreeStorageSize não inclui o espaço livre alocado para o armazenamento de documento . Consulte freeStorageSize para saber o tamanho total do armazenamento livre de documento .

indexFreeStorageSize não inclui compilações de índice em andamento.

Para incluir esse valor na saída,dbStats defina freeStorage 1como.

Atualizado na versão 7.0, 6.3.2, 6.0.7, 5.3.0, 5.2.1, 5.0.19 e 5.0.6

dbStats.totalSize

Soma do espaço em disco alocado para documentos e índices em todas as collections no banco de dados. Inclui espaço de armazenamento usado e gratuito. Esta é a soma de storageSize indexSizee.

dbStats.totalFreeStorageSize

Soma do espaço de armazenamento gratuito alocado para documentos e índices em todas as collections no banco de dados. Esta é a soma de freeStorageSize indexFreeStorageSizee.

Para incluir esse valor na saída,dbStats defina freeStorage 1como.

Atualizado na versão 5,3,0, 5.2.1 e 5.0.6.

dbStats.scaleFactor

scale valor usado pelo comando.

Se você especificou um fator de escala não inteiro, o MongoDB utilizará a parte inteira do fator especificado. Por exemplo, se você especificar um fator de escala de 1023.999, MongoDB utilizará 1023 como o fator de escala.

dbStats.fsUsedSize

Tamanho total de todo o espaço em disco em uso no sistema de arquivos onde o MongoDB armazena dados.

Dica

--dbpath

dbStats.fsTotalSize

Tamanho total de toda a capacidade de disco no sistema de arquivos onde o MongoDB armazena dados.

Exemplos

Os exemplos a seguir demonstram o uso dbStats do.

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