Definición
cursor.min()Importante
Método mongosh
Esta página documenta un método
mongosh. Esta no es la documentación para un driver específico de lenguaje, como Node.js.Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.
Especifica el límite inferior inclusivo para un índice específico con el fin de restringir los resultados de
find().min()proporciona una forma de especificar límites inferiores en los índices de clave compuesta.El método
min()tiene el siguiente parámetro:ParameterTipoDescripciónindexBoundsDocumento
El límite inferior inclusivo para las claves de índice.
El parámetro
indexBoundstiene la siguiente forma de prototipo:{ field1: <min value>, field2: <min value2>, fieldN:<min valueN> }
Nota
Uso del índice
Tip
min() existe principalmente para apoyar el proceso de mongos.
Compatibilidad
Este método está disponible en implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
Nota
Este comando es compatible con todos los clústeres de MongoDB Atlas. Para obtener información sobre el soporte de Atlas para todos los comandos, consulte Comandos no compatibles.
MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB
MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.
Comportamientos
Interacción con la selección de índices
Debido a que min() requiere un índice en un campo, y obliga a la query a usar este índice, es posible que prefiera el operador $gte para la query si es posible. Considera el siguiente ejemplo:
db.products.find( { $in: [ 6, 7 ] } ).min( { price: Decimal128("1.39") } ).hint( { price: 1 })
La consulta utilizará el índice en el campo price, aunque el índice en _id pueda ser mejor.
Límites del índice
min() sin max()
Los métodos min() y max() indican que el sistema debe evitar la planificación normal de consultas. Construyen un escaneo de índice donde los límites del índice están explícitamente especificados por los valores dados en min() y max().
Advertencia
Si uno de los dos límites no se especifica, el plan del query será una exploración de índice que no está delimitada en un lado. Esto puede degradar el rendimiento en comparación con una query que no contenga ninguno de los operadores, o una que use ambos operadores para restringir más rigurosamente el escaneo del índice.
Ejemplo
A menos que la find() query sea una condición de igualdad en el campo _id { _id: <value> }, debes especificar explícitamente el índice con el método hint() para ejecutar min().
Para los siguientes ejemplos, crea una muestra de colección llamada products que contenga los siguientes documentos:
db.products.insertMany([ { "_id" : 1, "item" : "apple", "type" : "honey crisp", "price" : Decimal128("1.99") }, { "_id" : 2, "item" : "apple", "type" : "fuji", "price" : Decimal128("1.99") }, { "_id" : 3, "item" : "apple", "type" : "jonagold", "price" : Decimal128("1.29") }, { "_id" : 4, "item" : "apple", "type" : "jonathan", "price" : Decimal128("1.29") }, { "_id" : 5, "item" : "apple", "type" : "mcintosh", "price" : Decimal128("1.29") }, { "_id" : 6, "item" : "apple", "type" : "cortland", "price" : Decimal128("1.29") }, { "_id" : 7, "item" : "orange", "type" : "cara cara", "price" : Decimal128("2.99") }, { "_id" : 9, "item" : "orange", "type" : "satsuma", "price" : Decimal128("1.99") }, { "_id" : 8, "item" : "orange", "type" : "valencia", "price" : Decimal128("0.99") }, { "_id" : 10, "item" : "orange", "type" : "navel", "price" : Decimal128("1.39") } ])
Crea los siguientes índices para la colección:
db.products.createIndexes( [ { "item" : 1, "type" : 1 }, { "item" : 1, "type" : -1 }, { "price" : 1 } ] )
Usando el orden del índice
{ item: 1, type: 1 },min()limita la query a los documentos que están en o por encima del límite de clave de índice deitemigual aappleytypeigual ajonagold, como en el siguiente ejemplo:db.products.find().min( { item: 'apple', type: 'jonagold' } ).hint( { item: 1, type: 1 } ) La query devuelve los siguientes documentos:
{ "_id" : 3, "item" : "apple", "type" : "jonagold", "price" : Decimal128("1.29") } { "_id" : 4, "item" : "apple", "type" : "jonathan", "price" : Decimal128("1.29") } { "_id" : 5, "item" : "apple", "type" : "mcintosh", "price" : Decimal128("1.29") } { "_id" : 7, "item" : "orange", "type" : "cara cara", "price" : Decimal128("2.99") } { "_id" : 10, "item" : "orange", "type" : "navel", "price" : Decimal128("1.39") } { "_id" : 9, "item" : "orange", "type" : "satsuma", "price" : Decimal128("1.99") } { "_id" : 8, "item" : "orange", "type" : "valencia", "price" : Decimal128("0.99") } Utilizando el orden de índice
{ price: 1 },min()limita la query a los documentos que están en o por encima del límite de clave de índice depriceigual a1.39ymax()limita la query a los documentos que están por debajo del límite de clave de índice depriceigual a1.99:db.products.find().min( { price: Decimal128("1.39") } ).max( { price: Decimal128("1.99") } ).hint( { price: 1 } ) La query devuelve los siguientes documentos:
{ "_id" : 10, "item" : "orange", "type" : "navel", "price" : Decimal128("1.39") }