MongoDB\Collection::count()

Definição

MongoDB\Collection::count()

Conte o número de documentos que correspondem aos critérios de filtro.

function count(
    array|object $filter = [],
    array $options = []
): integer

Parâmetros

$filter : array|object

Os critérios de filtro que especificam os documentos a serem contados.

$options : array

Uma array especificando as opções desejadas.

Nome	Tipo	Descrição
agrupamento	array|object	A colocação permite que os usuários especifiquem regras específicas do idioma para comparação de string , como regras para letras maiúsculas e marcas de acento. Ao especificar agrupamento, o campo locale é obrigatório; todos os outros campos de agrupamento são opcionais. Para obter descrições dos campos, consulte Documento de agrupamento. Se o agrupamento não for especificado, mas a coleção tiver um agrupamento padrão, a operação usará o agrupamento especificado para a coleção. Se nenhum agrupamento for especificado para a coleção nem para a operação, o MongoDB usará a comparação binária simples usada nas versões anteriores para comparações de strings.
comment	misto	Permite ao usuário especificar um comentário arbitrário para ajudar a rastrear a operação por meio do profiler de banco de dados, da saída currentOp e dos registros. Esta opção está disponível desde o MongoDB 4.4 e resultará em uma exceção no momento da execução se for especificada para uma versão mais antiga do servidor. Novidade na versão 1.13.
dica	string|array|objeto	O índice a ser utilizado. Especifique o nome do índice como uma string ou o padrão da chave do índice como um documento. Se especificado, o sistema de query considerará apenas os planos usando o índice sugerido. Alterado na versão 1.2: Se um documento for fornecido, ele será passado para o comando como está. Anteriormente, a biblioteca convertia o padrão de chave em um nome de índice.
limit	inteiro	O número máximo de documentos correspondentes a serem devolvidos.
maxTimeMS	inteiro	O limite de tempo cumulativo em milésimos de segundo para operações de processamento no cursor. O MongoDB aborta a operação o mais cedo possível após o ponto de interrupção.
readConcern	MongoDB\Driver\ReadConcern	Preocupação de leitura a ser usada para a operação. O padrão é a preocupação de leitura da coleção. Não é possível especificar uma preocupação de leitura para operações individuais como parte de uma transação. Em vez disso, defina a opção readConcern ao iniciar a transação.
readPreference	MongoDB\Driver\ReadPreference	Preferência de leitura a ser usada na operação. O padrão é a preferência de leitura da coleção.
session	MongoDB\Driver\Session	Sessão do cliente a ser associada à operação. Novidade na versão 1.3.
ignorar	inteiro	O número de documentos correspondentes a ignorar antes de retornar os resultados.

Return Values

O número de documentos que correspondem aos critérios de filtro.

Erros/exceções

MongoDB\Exception\UnexpectedValueException se a resposta do comando do servidor estiver malformada.

MongoDB\Exception\UnsupportedException se as opções forem usadas e não aceitas pelo servidor selecionado (p. ex., collation, readConcern, writeConcern).

MongoDB\Exception\InvalidArgumentException para erros relacionados à análise de parâmetros ou opções.

MongoDB\Driver\Exception\RuntimeException para outros erros no nível da extensão (por exemplo erros de conexão).

Comportamento

Este método é preterido e não pode ser executado dentro de uma transação. Sempre foi implementado usando o comando de contagem . O comportamento do comando count difere dependendo das opções passadas para ele e pode ou não fornecer uma contagem precisa. Quando nenhum filtro de query é fornecido, o comando count fornece uma estimativa utilizando metadados de coleção. Mesmo quando fornecido com um filtro de query, o comando count pode retornar resultados imprecisos com um cluster fragmentado se documentos órfãos existirem ou se uma migração de bloco estiver em andamento. O método MongoDB\Collection::countDocuments() evita totalmente esses problemas de cluster fragmentado .

Ao avaliar critérios de query, oMongoDB compara tipos e valores de acordo com suas próprias regras de comparação para BSON types, o que difere da comparação do e digite PHP malabarismo regras. Ao corresponder a um tipo BSON especial, os critérios de query devem usar a respectiva classe BSON na extensão (por exemplo use MongoDB\BSON\ObjectId para corresponder a um ObjectId).

Veja também

• referência do comando de contagem no manual do MongoDB

• MongoDB\Collection::countDocuments()

• MongoDB\Collection::estimatedDocumentCount()