Especificar uma query

Visão geral

Neste guia, você pode aprender como especificar uma query usando o driver C++ .

Você pode refinar o conjunto de documentos que uma query retorna criando um filtro de query. Um filtro de query é uma expressão que especifica os critérios de pesquisa que o MongoDB usa para corresponder a documentos em uma operação de leitura ou gravação. Em um filtro de query, você pode solicitar ao driver que pesquise documentos que tenham uma correspondência exata à sua query ou pode compor filtros de query para Express critérios de correspondência mais complexos.

mongocxx::uri uri("<connection string>");
mongocxx::client client(uri);
auto db = client["db"];
auto collection = db["fruits"];
std::vector<bsoncxx::document::value> fruits;
fruits.push_back(make_document(kvp("_id", 1), kvp("name", "apples"), kvp("qty", 5), kvp("rating", 3), kvp("color", "red"), kvp("type", make_array("fuji", "honeycrisp"))));
fruits.push_back(make_document(kvp("_id", 2), kvp("name", "bananas"), kvp("qty", 7), kvp("rating", 4), kvp("color", "yellow"), kvp("type", make_array("cavendish"))));
fruits.push_back(make_document(kvp("_id", 3), kvp("name", "oranges"), kvp("qty", 6), kvp("rating", 2), kvp("type", make_array("naval", "mandarin"))));
fruits.push_back(make_document(kvp("_id", 4), kvp("name", "pineapples"), kvp("qty", 3), kvp("rating", 5), kvp("color", "yellow")));
auto result = collection.insert_many(fruits);

Correspondência exata

Consultas de valor literal retornam documentos que têm uma correspondência exata ao seu filtro de consulta.

O exemplo seguinte especifica um filtro de consulta como um parâmetro para o método find() . O código retorna todos os documentos em que o valor do campo color é "yellow":

auto cursor = collection.find(make_document(kvp("color", "yellow")));
for (auto &&doc : cursor)
{
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : 2, "name" : "bananas", "qty" : 7, "rating" : 4, "color" : "yellow", "type" : [ "cavendish" ] }
{ "_id" : 4, "name" : "pineapple", "qty" : 3, "rating" : 5, "color" : "yellow" }

auto cursor = collection.find({});

Operadores de comparação

Os operadores de comparação avaliam um valor de campo de documento em relação a um valor especificado em seu filtro de query. A seguinte lista define operadores de comparação comuns:

• $gt: Maior que

• $lte: Menor ou Igual

• $ne: Diferente

Para visualizar uma lista completa de operadores de comparação, consulte o guia Operadores de query de comparação no manual do MongoDB Server .

O exemplo a seguir especifica um operador de comparação em um filtro de query como um parâmetro para o método find() . O código retorna todos os documentos que têm um valor de campo rating maior que 2:

auto cursor = collection.find(make_document(kvp("rating", make_document(kvp("$gt", 2)))));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : 1, "name" : "apples", "qty" : 5, "rating" : 3, "color" : "red", "type" : [ "fuji", "honeycrisp" ] }
{ "_id" : 2, "name" : "bananas", "qty" : 7, "rating" : 4, "color" : "yellow", "type" : [ "cavendish" ] }
{ "_id" : 4, "name" : "pineapples", "qty" : 3, "rating" : 5, "color" : "yellow" }

Operadores lógicos

Os operadores lógicos correspondem aos documentos usando lógica aplicada aos resultados de dois ou mais conjuntos de expressões. A lista a seguir descreve cada operador lógico:

• $and: retorna todos os documentos que correspondem às condições de todas as cláusulas

• $or: retorna todos os documentos que correspondem às condições de uma cláusula

• $nor: Retorna todos os documentos que não correspondem às condições de nenhuma cláusula

• $not: retorna todos os documentos que não correspondem à expressão

Para saber mais sobre operadores lógicos, consulte o guia Operadores lógicos de query no manual do MongoDB Server .

O exemplo seguinte especifica um operador lógico em um filtro de query como um parâmetro para o método find() . O código retorna todos os documentos em que o valor do campo qty é maior que 5 ou o valor do campo color é "yellow":

auto cursor = collection.find(
    make_document(kvp("$or",
                        make_array(make_document(kvp("qty", make_document(kvp("$gt", 5)))),
                                    make_document(kvp("color", "yellow"))))));
for (auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : 2, "name" : "bananas", "qty" : 7, "rating" : 4, "color" : "yellow", "type" : [ "cavendish" ] }
{ "_id" : 3, "name" : "oranges", "qty" : 6, "rating" : 2, "type" : [ "naval", "mandarin" ] }
{ "_id" : 4, "name" : "pineapples", "qty" : 3, "rating" : 5, "color" : "yellow" }

Operadores de array

Os operadores de array correspondem aos documentos com base no valor ou na quantidade de elementos em um campo de array . A seguinte lista descreve os operadores de array disponíveis:

• $all: retorna documentos com arrays que contêm todos os elementos da query

• $elemMatch: Retorna documentos se um elemento em seu campo de matriz corresponder a todas as condições na query

• $size: retorna todos os documentos com arrays de um tamanho especificado

Para saber mais sobre operadores de array, consulte o guia Operadores de query de array no manual do MongoDB Server .

O exemplo seguinte especifica um operador de array em um filtro de query como um parâmetro para o método find() . O código retorna todos os documentos em que o campo de array type contém elementos 2 :

auto cursor = collection.find(make_document(kvp("type", make_document(kvp("$size", 2)))));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : 1, "name" : "apples", "qty" : 5, "rating" : 3, "color" : "red", "type" : [ "fuji", "honeycrisp" ] }
{ "_id" : 3, "name" : "oranges", "qty" : 6, "rating" : 2, "type" : [ "naval", "mandarin" ] }

Operadores de elementos

Os operadores de elemento consultam os dados com base na presença ou tipo de campo.

Para saber mais sobre os operadores de elementos, consulte o guia Operadores de query de elementos no manual do MongoDB Server .

O exemplo seguinte especifica um operador de elemento em um filtro de query como um parâmetro para o método find() . O código retorna todos os documentos que têm um campo color :

auto cursor = collection.find(make_document(kvp("color", make_document(kvp("$exists", true)))));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : 1, "name" : "apples", "qty" : 5, "rating" : 3, "color" : "red", "type" : [ "fuji", "honeycrisp" ] }
{ "_id" : 2, "name" : "bananas", "qty" : 7, "rating" : 4, "color" : "yellow", "type" : [ "cavendish" ] }
{ "_id" : 4, "name" : "pineapples", "qty" : 3, "rating" : 5, "color" : "yellow" }

Operadores de avaliação

Os operadores de avaliação retornam dados com base em avaliações de campos individuais ou documentos de toda a coleção.

A seguinte lista descreve operadores de avaliação comuns:

• $text: Executa uma pesquisa de texto nos documentos

• $regex: retorna documentos que correspondem a uma expressão regular especificada

• $mod: Executa uma operação de módulo no valor de um campo e retorna documentos onde o restante é um valor especificado

Para visualizar uma lista completa de operadores de avaliação, consulte o guia Operadores de query de avaliação no manual do MongoDB Server .

O exemplo seguinte especifica um operador de avaliação em um filtro de query como um parâmetro para o método find() . O código usa uma expressão regular para retornar todos os documentos nos quais o valor do campo name tem pelo menos dois "p" caracteres consecutivos:

auto cursor = collection.find(make_document(kvp("name", make_document(kvp("$regex", "p{2,}")))));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : 1, "name" : "apples", "qty" : 5, "rating" : 3, "color" : "red", "type" : [ "fuji", "honeycrisp" ] }
{ "_id" : 4, "name" : "pineapples", "qty" : 3, "rating" : 5, "color" : "yellow" }

Informações adicionais

Para saber mais sobre como query documentos, consulte o guia Consultar documentos no manual do MongoDB Server .

Para saber mais sobre como recuperar documentos com o driver C++ , consulte o guia Recuperar dados .