count (comando de banco de dados)

Campos de comando

count tem os seguintes campos:

readConcern: { level: <value> }

collation: {
    locale: <string>,
    caseLevel: <boolean>,
    caseFirst: <string>,
    strength: <int>,
    numericOrdering: <boolean>,
    alternate: <string>,
    maxVariable: <string>,
    backwards: <boolean>
 }

Contagens Imprecisas Sem Predicado de Consulta

Ao chamar count sem um predicado de query, você pode receber contagens imprecisas de documentos. Sem um predicado de query, os comandos count retornam resultados com base nos metadados da coleção, o que pode resultar em uma contagem aproximada. Em particular:

• Em um cluster fragmentado, a contagem resultante não filtra corretamente documentos órfãos.

• Após um desligamento não limpo ou sincronização inicial, a contagem pode estar incorreta.

Para contagens com base nos metadados da coleção, consulte também o estágio do pipeline do CollStats com a opção de contagem.

Contagem e Transações

Quando você usa count em uma transação, a contagem resultante não filtrará transações multidocumentos não confirmada.

Para obter detalhes, consulte Operações de transações e contagem.

Precisão e clusters fragmentados

Em um cluster fragmentado, o comando count quando executado sem um predicado de consulta pode resultar em uma contagem imprecisa se documentos órfãos existirem ou se uma migração de parte estiver em andamento.

Para evitar estas situações, em um cluster fragmentado, utilize o método db.collection.aggregate():

Você pode usar o estágio $count para contar os documentos. Por exemplo, a seguinte operação conta os documentos em uma coleção:

db.collection.aggregate( [
   { $count: "myCount" }
])

O estágio $count é equivalente à seguinte sequência $group + $project:

db.collection.aggregate( [
   { $group: { _id: null, count: { $sum: 1 } } },
   { $project: { _id: 0 } }
] )

Precisão após Desligamento Inesperado

Após um desligamento impuro de um mongod usando o mecanismo de armazenamento Wired Tiger, as estatísticas de contagem relatadas por count podem ser imprecisas.

A quantidade de desvio depende do número de operações de inserção, atualização ou exclusão executadas entre o último ponto de verificação e o desligamento não limpo. Os pontos de verificação geralmente ocorrem a cada 60 segundos. No entanto, mongod instâncias executadas com configurações de --syncdelay não padrão podem ter pontos de verificação mais ou menos frequentes.

Execute validate em cada collection no mongod para restaurar as estatísticas depois de um desligamento impróprio.

Após um desligamento impróprio:

• validate atualiza a estatística de contagem na collStats saída com o valor mais recente.

• Outras estatísticas, como o número de documentos inseridos ou removidos na collStats saída , são estimativas.

Desconexão do cliente

Se o cliente que emitiu count se desconectar antes da conclusão da operação, o MongoDB marcará count para encerramento usando killOp.

Contagem de todos os documentos

A seguinte operação conta todos os documentos na coleção orders:

db.runCommand( { count: 'orders' } )

A operação retorna o seguinte documento:

{ "n" : 26, "ok" : 1 }

Contagem de documentos que correspondem a uma query

A seguinte operação conta documentos na coleção orders onde o campo ord_dt é maior que Date('01/01/2012'):

db.runCommand( { count:'orders',
                 query: { ord_dt: { $gt: new Date('01/01/2012') } }
               } )

A operação retorna o seguinte documento:

{ "n" : 13, "ok" : 1 }

Ignorar documentos na contagem

A operação a seguir conta documentos na coleção orders em que o campo ord_dt é maior que Date('01/01/2012'), ignorando as primeiras 10 correspondências:

db.runCommand( { count:'orders',
                 query: { ord_dt: { $gt: new Date('01/01/2012') } },
                 skip: 10 }  )

A operação retorna o seguinte documento:

{ "n" : 3, "ok" : 1 }

Especificar o índice a ser usado

A operação seguinte utiliza o índice { status: 1 } para contar documentos na coleção orders onde o campo ord_dt é maior que Date('01/01/2012') e o campo status é igual a "D":

db.runCommand(
   {
     count:'orders',
     query: {
              ord_dt: { $gt: new Date('01/01/2012') },
              status: "D"
            },
     hint: { status: 1 }
   }
)

A operação retorna o seguinte documento:

{ "n" : 1, "ok" : 1 }

Substituir o Padrão Atenção com a Leitura

Para substituir o nível de preocupação de leitura padrão do "local", utilize a opção readConcern.

A operação a seguir em um conjunto de réplicas especifica uma read concern de "majority" para ler a cópia mais recente dos dados confirmados como gravados na maioria dos nós.

db.runCommand(
   {
     count: "restaurants",
     query: { rating: { $gte: 4 } },
     readConcern: { level: "majority" }
   }
)

Para garantir que um único thread possa ler suas próprias gravações, use "majority" read concern e "majority" write concern em relação ao primário do conjunto de réplicas.