$inEl
$inEl operador selecciona los documentos donde el valor de un campo es igual a cualquier valor en la matriz especificada.
Compatibilidad
Puedes usar $in para implementaciones alojadas en los siguientes entornos:
MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube
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.
Sintaxis
El operador $in tiene la siguiente forma:
{ field: { $in: [ <value1>, <value2>, ... <valueN> ] } }
Para la comparación de diferentes valores de tipo BSON, consulta el orden de comparación especificado de BSON.
Si field tiene una matriz, el operador selecciona los documentos $in cuyo field tenga una matriz que contenga al menos un elemento que coincida con un valor de la matriz especificada. Por ejemplo,,, <value1> <value2>etc.
$in Compara cada parámetro con cada documento de la colección, lo que puede causar problemas de rendimiento. Para mejorar el rendimiento:
Limite el número de parámetros pasados a
$ina decenas de valores. Usar cientos de parámetros puede afectar negativamente el rendimiento de la consulta.Crea un índice en el
fieldque deseas consultar.
Nota
Este documento describe el operador de la query $in. Para el operador de agregación $in, consulte $in (operador de expresión).
Consultar datos en Atlas mediante la búsqueda de Atlas
Para los datos almacenados en MongoDB Atlas, puede usar el operador "Buscar en Atlas" al ejecutar $search consultas. Ejecutar $in después $search de tiene menor rendimiento que ejecutar con $search el operador "In".
Para obtener más información sobre la versión Atlas Search de este operador, consulte el operador en la documentación de Atlas.
Ejemplos
Para crear la colección inventory utilizada en los ejemplos, ejecute:
db.inventory.insertMany( [ { item: "Pens", quantity: 350, tags: [ "school", "office" ] }, { item: "Erasers", quantity: 15, tags: [ "school", "home" ] }, { item: "Maps", tags: [ "office", "storage" ] }, { item: "Books", quantity: 5, tags: [ "school", "storage", "home" ] } ] )
Match Values
Esta consulta selecciona documentos en la colección inventory donde el valor del campo quantity es 5 o 15:
db.inventory.find( { quantity: { $in: [ 5, 15 ] } }, { _id: 0 } )
La salida:
{ item: 'Erasers', quantity: 15, tags: [ 'school', 'home' ] }, { item: 'Books', quantity: 5, tags: [ 'school', 'storage', 'home' ] }
Aunque puede escribir la consulta utilizando el operador,$or utilice el operador $in $or en lugar del operador cuando realice verificaciones de igualdad en el mismo campo.
Coincidir valores en una matriz
La siguiente operación establece updateMany() el exclude campo en false cuando la tags matriz tiene al menos un elemento que coincide "home" con "school" o:
db.inventory.updateMany( { tags: { $in: [ "home", "school" ] } }, { $set: { exclude: false } } )
Ejemplo de salida:
{ item: 'Pens', quantity: 350, tags: [ 'school', 'office' ], exclude: false }, { item: 'Erasers', quantity: 15, tags: [ 'school', 'home' ], exclude: false }, { item: 'Books', quantity: 5, tags: [ 'school', 'storage', 'home' ], exclude: false }
Para obtener más ejemplos sobre la consulta de arreglos, consulte:
Para obtener ejemplos adicionales sobre query, consulta Documentos de query.
Usa $in con una Expresión Regular
El operador permite seleccionar documentos mediante expresiones regulares $in del /pattern/ formato. No se pueden usar expresiones $regex dentro $in de.
Esta consulta selecciona documentos en la colección inventory donde el campo tags comienza con be o st:
db.inventory.find( { tags: { $in: [ /^be/, /^st/ ] } } )
La consulta selecciona todos los documentos de la colección inventory donde el campo tags tiene una cadena que comienza con be o st o una matriz con al menos un elemento que comienza con be o st.