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 filtrará 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 o número de todos os documentos na collection orders:

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

No resultado, o n, que representa a contagem, é 26, e o status de comando ok é 1:

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

Contagem de documentos que correspondem a uma query

A seguinte operação retorna uma contagem dos documentos na collection orders onde o valor do campo ord_dt é maior que Date('01/01/2012'):

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

No resultado, o n, que representa a contagem, é 13 e o status de comando ok é 1:

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

Ignorar documentos na contagem

A operação a seguir retorna uma contagem dos documentos na collection orders em que o valor do campo ord_dt é maior que Date('01/01/2012') e ignora os primeiros documentos 10 correspondentes:

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

No resultado, o n, que representa a contagem, é 3 e o status de comando ok é 1:

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

Especificar o índice a ser usado

A operação seguinte utiliza o índice { status: 1 } para retornar uma contagem dos documentos na collection orders onde o valor do 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 }
   }
)

No resultado, o n, que representa a contagem, é 1 e o status de comando ok é 1:

{ "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.