/ /

Contagem de documentos

Visão geral

Neste guia, você pode aprender como recuperar contagens precisas e estimadas do número de documentos em uma coleção.

Dados de amostra

Os exemplos neste guia utilizam a coleção do movies no banco de dados do sample_mflix a partir do conjunto de dados de amostra do Atlas. Para saber como criar um cluster MongoDB Atlas gratuito e carregar os conjuntos de dados de amostra, consulte o guia MongoDB Get Started.

Recuperar uma contagem precisa

Use a função mongoc_collection_count_documents() para contar o número de documentos que estão em uma collection. Para contar o número de documentos que correspondem aos critérios de pesquisa especificados, passe um filtro de query para a função mongoc_collection_count_documents().

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

Contagem de todos os documentos

Para retornar uma contagem de todos os documentos na collection, chame a função mongoc_collection_count_documents() com um filtro de query vazio, conforme mostrado no exemplo a seguir :

bson_error_t error;
bson_t *empty_query = bson_new();
int64_t count = 
    mongoc_collection_count_documents(collection, empty_query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(empty_query);

Contagem de documentos específicos

Para retornar uma contagem de documentos que correspondam a critérios de pesquisa específicos, especifique sua query na função mongoc_collection_count_documents(). O exemplo a seguir imprime uma contagem de todos os documentos na collection movies que têm um valor de campo year igual a 1930:

bson_error_t error;
bson_t *query = BCON_NEW("year", BCON_INT32(1930));
int64_t count =
    mongoc_collection_count_documents(collection, query, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(query);

Personalizar comportamento de contagem

A função mongoc_collection_count_documents() aceita parâmetros opcionais na forma de uma estrutura bson_t, que representa um conjunto de opções que você pode utilizar para configurar a operação de contagem. Se você não especificar nenhuma opção, o driver não personalizará a operação de contagem.

A tabela a seguir descreve as opções que você pode definir para personalizar countDocuments():

Opção	Descrição
`comment`	Especifica um comentário a ser anexado à operação.
`skip`	Define o número de documentos a ignorar antes de retornar os resultados.
`limit`	Define o número máximo de documentos a contar. Deve ser um número inteiro positivo.
`collation`	Especifica o tipo de agrupamento de idiomas a ser usado ao classificar os resultados. Para obter mais informações, consulte Agrupamento no manual do MongoDB Server .
`hint`	Define o índice para digitalizar documentos.

Para obter uma lista completa de opções, consulte a documentação da API para mongoc_collection_count_documents().

O exemplo a seguir usa uma estrutura bson_t para adicionar um comentário à operação mongoc_collection_count_documents():

bson_error_t error;
bson_t *opts = BCON_NEW("comment", BCON_UTF8("Retrieving count"));
int64_t count =
    mongoc_collection_count_documents(collection, bson_new(), opts, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(opts);

Recuperar uma contagem estimada

Use a função mongoc_collection_estimated_document_count() para recuperar uma estimativa do número de documentos em uma collection. A função 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 imprime o número estimado de documentos em uma collection:

bson_error_t error;
int64_t count =
    mongoc_collection_estimated_document_count(collection, NULL, NULL, NULL, &error);
printf("%" PRId64 "\n", count);

Personalizar comportamento de contagem estimada

A função mongoc_collection_estimated_document_count() aceita parâmetros opcionais na forma de uma estrutura bson_t, que representa opções que você pode utilizar para configurar a operação de contagem. Se você não especificar nenhuma opção, o driver não personalizará a operação de contagem.

A tabela a seguir descreve as opções que você pode definir para personalizar mongoc_collection_estimated_document_count():

Opção	Descrição
`comment`	Especifica um comentário a ser anexado à operação.
`collation`	Especifica o tipo de agrupamento de idiomas a ser usado ao classificar os resultados. Para obter mais informações, consulte Agrupamento no manual do MongoDB Server .

Para obter uma lista completa de opções, consulte a documentação da API para mongoc_collection_estimated_document_count().

O exemplo a seguir usa uma estrutura bson_t para adicionar um comentário à operação mongoc_collection_estimated_document_count():

bson_error_t error;
bson_t *opts = BCON_NEW("comment", BCON_UTF8("Retrieving count"));
int64_t count =
    mongoc_collection_estimated_document_count(collection, opts, NULL, NULL, &error);
printf("%" PRId64 "\n", count);
bson_destroy(opts);

Documentação da API

Para saber mais sobre qualquer uma das funções discutidas nesta guia, consulte a seguinte documentação da API:

Voltar

Especifique documentos a serem devolvidos

Valores de campo distintos