Especifica un query

Overview

En esta guía, puedes aprender a especificar una query utilizando el driver Ruby.

Puede refinar el conjunto de documentos que devuelve una consulta creando un filtro de consulta. Un filtro de consulta es una expresión que especifica los criterios de búsqueda que MongoDB utiliza para encontrar documentos en una operación de lectura o escritura. En un filtro de consulta, puede solicitar al controlador que busque documentos que coincidan exactamente con su consulta o crear filtros de consulta para expresar criterios de coincidencia más complejos.

database = client.use('db')
collection = database[:fruits]
# Inserts documents representing fruits
fruits = [
{ _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: 3, name: 'oranges', qty: 6, rating: 2, type: ['naval', 'mandarin'] },
{ _id: 4, name: 'pineapples', qty: 3, rating: 5, color: 'yellow' }
]
collection.insert_many(fruits)

Coincidencia exacta

Las consultas de valor literal devuelven documentos que coinciden exactamente con su filtro de consulta.

El siguiente ejemplo especifica un filtro de consulta como parámetro del método find. El código devuelve todos los documentos cuyo valor del campo color es 'yellow':

filter = { color: 'yellow' }
results = collection.find(filter)
results.each do |doc|
  puts doc
end

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

results = collection.find

Operadores de comparación

Los operadores de comparación evalúan el valor de un campo de documento con respecto a un valor especificado en el filtro de consulta. La siguiente lista describe los operadores de comparación más comunes:

• $gt: Devuelve documentos en los que el valor del campo dado es mayor que el valor especificado

• $lte: Devuelve documentos en los que el valor del campo dado es menor o igual que el valor especificado.

• $ne: Devuelve documentos en los que el valor del campo dado no es igual al valor especificado

El siguiente ejemplo especifica un operador de comparación en un filtro de consulta como parámetro del método find. El código devuelve todos los documentos cuyo valor de campo rating sea mayor que 2:

filter = { rating: { '$gt' => 2 } }
results = collection.find(filter)
results.each do |doc|
  puts doc
end

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

Los operadores lógicos vinculan documentos mediante la lógica aplicada a los resultados de dos o más conjuntos de expresiones. La siguiente lista describe cada operador lógico:

• $and:Devuelve documentos que coinciden con las condiciones de todas las cláusulas

• $or: Devuelve documentos que coinciden con las condiciones de una cláusula

• $nor:Devuelve documentos que no coinciden con las condiciones de ninguna cláusula

• $not: Devuelve documentos que no coinciden con la expresión

El siguiente ejemplo especifica un operador lógico en un filtro de consulta como parámetro del find método. El código devuelve todos los documentos cuyo qty valor de campo sea mayor que 5 o cuyo color valor de campo 'yellow' sea:

filter = { '$or' => [{ qty: { '$gt' => 5 } }, { color: 'yellow' }] }
results = collection.find(filter)
results.each do |doc|
  puts doc
end

{"_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 arreglos

Los operadores de arreglo hacen coincidir documentos basados en el valor o cantidad de elementos en un campo de arreglo. La siguiente lista describe cada operador de arreglo:

• $all: Devuelve documentos con matrices que contienen todos los elementos de la consulta

• $elemMatch: Devuelve documentos si un elemento en su campo de matriz coincide con todas las condiciones de la consulta

• $size: Devuelve documentos con matrices de un tamaño especificado

El siguiente ejemplo especifica un operador de matriz en un filtro de consulta como parámetro del método find. El código devuelve todos los documentos en los que el campo de matriz type contiene 2 elementos:

filter = { type: { '$size' => 2 } }
results = collection.find(filter)
results.each do |doc|
  puts doc
end

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

Los operadores de elementos consultan datos según la presencia o el tipo de campo. La siguiente lista describe cada operador de elemento:

• $exists: Devuelve documentos que contienen el campo especificado

• $type: Devuelve documentos que contienen un campo del tipo especificado

El siguiente ejemplo especifica un operador de elemento en un filtro de consulta como parámetro del método find. El código devuelve todos los documentos que tienen un campo color:

filter = { color: { '$exists' => true } }
results = collection.find(filter)
results.each do |doc|
  puts doc
end

{"_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 evaluación

Los operadores de evaluación devuelven datos basados ​​en evaluaciones de campos individuales o de los documentos de toda la colección. La siguiente lista describe los operadores de elementos comunes:

• $text:Realiza una búsqueda de texto en los documentos

• $regex: Devuelve documentos que coinciden con una expresión regular especificada

• $mod: Realiza una operación de módulo sobre el valor de un campo y devuelve documentos donde el resto es un valor especificado

El siguiente ejemplo especifica un operador de evaluación en un filtro de consulta como parámetro del método find. El código utiliza una expresión regular para devolver todos los documentos cuyo valor del campo name tenga al menos dos caracteres 'p' consecutivos:

filter = { name: /p{2,}/ }
results = collection.find(filter)
results.each do |doc|
  puts doc
end

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

Información Adicional

Para obtener más información sobre cómo consultar documentos, consulte Consultar documentos en el manual de MongoDB Server.

Para obtener más información sobre cómo recuperar documentos mediante el controlador Ruby, consulte la Guía de búsqueda de documentos.