Contagem de documentos

Nesta página

Visão geral

Dados de amostra
Recuperar uma contagem precisa
Contagem de todos os documentos
Contagem de documentos específicos
Personalizar comportamento de contagem
Recuperar uma contagem estimada
Personalizar comportamento de contagem estimada
Documentação da API

Visão geral

Neste guia, você pode aprender como usar o driver C++ para recuperar uma contagem precisa e estimada do número de documentos em uma coleção. O método count_documents() retorna o número exato de documentos que correspondem a um filtro de query ou que existem em uma collection e o método estimated_document_count() retorna o número estimado de documentos em uma collection.

Dados de amostra

Os exemplos neste guia utilizam a coleção do companies no banco de dados de dados do sample_training a partir dos conjuntos de dados de amostra do Atlas. Para acessar essa coleção a partir do seu aplicação C++ , instancie um mongocxx::client que se conecte a um Atlas cluster e atribua os seguintes valores às suas variáveis db e collection :

auto db = client["sample_training"];
auto collection = db["companies"];

Para saber como criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o guia Iniciar com Atlas .

Recuperar uma contagem precisa

Use o método count_documents() para contar o número de documentos que estão em uma coleção. Para contar o número de documentos que correspondem a um critério de pesquisa específico, passe um documento de filtro de query para o método count_documents() .

Para saber mais sobre como especificar uma query, consulte o guia Especificar uma query .

Contagem de todos os documentos

Para retornar uma contagem de todos os documentos na collection, passe um documento filtro vazio para o método count_documents() , conforme mostrado no exemplo a seguir:

auto result = collection.count_documents({});
std::cout << "Number of documents: " << result << std::endl;

Number of documents: 9500

Contagem de documentos específicos

Para retornar uma contagem de documentos que correspondam a critérios de pesquisa específicos, passe seu documento de filtro de query para o método count_documents() .

O exemplo a seguir conta o número de documentos que têm 2010 founded_year de :

auto result = collection.count_documents(make_document(kvp("founded_year", 2010)));
std::cout << "Number of companies founded in 2010: " << result << std::endl;

Number of companies founded in 2010: 33

Personalizar comportamento de contagem

Você pode modificar o comportamento do método count_documents() passando uma instância da classe mongocxx::options::count como parâmetro. A tabela seguinte descreve os campos que você pode definir em uma instância do mongocxx::options::count :

Campo	Descrição
`collation`	The collation to use for the operation. Type: `bsoncxx::document::view_or_value`
`hint`	The index to use for the operation. Type: `mongocxx::hint`
`comment`	The comment to attach to the operation. Type: `bsoncxx::types::bson_value::view_or_value`
`limit`	The maximum number of documents to count. This value must be a positive integer. Type: `std::int64_t`
`max_time`	The maximum amount of time in milliseconds that the operation can run. Type: `std::chrono::milliseconds`
`skip`	The number of documents to skip before counting documents. Type: `std::int64_t`
`read_preference`	The read preference to use for the operation. Type: `mongocxx::read_preference`

O exemplo a seguir usa o método count_documents() para contar o número de documentos nos quais o campo number_of_employees tem o valor 50 e instrui a operação a contar um máximo de 100 resultados:

mongocxx::options::count opts;
opts.limit(100); 
auto result = collection.count_documents(make_document(kvp("number_of_employees", 50)), opts);
std::cout << "Number of companies with 50 employees: " << result << std::endl;

Number of companies with 50 employees: 100

Recuperar uma contagem estimada

Você pode recuperar uma estimativa do número de documentos em uma coleção ligando para o método estimated_document_count() . O método estima a quantidade de documentos com base nos metadados da collection, o que pode ser mais rápido do que realizar uma contagem precisa.

O exemplo a seguir estima o número de documentos em uma coleção:

auto result = collection.estimated_document_count();
std::cout << "Estimated number of documents: " << result << std::endl;

Estimated number of documents: 9500

Personalizar comportamento de contagem estimada

Você pode modificar o comportamento do método estimated_document_count() passando uma instância da classe mongocxx::options::estimated_document_count como parâmetro. A tabela seguinte descreve os campos que você pode definir em uma instância do mongocxx::options::estimated_document_count :

Campo	Descrição
`max_time`	The maximum amount of time in milliseconds that the operation can run. Type: `std::chrono::milliseconds`
`comment`	The comment to attach to the operation. Type: `bsoncxx::types::bson_value::view_or_value`
`read_preference`	The read preference to use for the operation. Type: `mongocxx::read_preference`

O exemplo a seguir usa o método estimated_document_count() para retornar uma estimativa do número de documentos na coleção e instrui a operação a ser executada por no máximo 1000 milissegundos:

mongocxx::options::estimated_document_count opts;
opts.max_time(std::chrono::milliseconds{1000}); 
auto result = collection.estimated_document_count(opts);
std::cout << "Estimated number of documents: " << result << std::endl;

Estimated number of documents: 9500

Documentação da API

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

Voltar

Valores de campo distintos

Cursors