Docs Menu
Docs Home
/ /
Arreglos
Docs Home
/ /
Predicados de query
/
Arreglos
Docs Home
/
Desarrollo
/
languaje del query
/
Predicados de query
/
Arreglos

$all

$all

El $all El operador selecciona los documentos cuyo valor de campo coincide con todos los valores especificados. Los documentos coincidentes pueden contener un campo cuyo valor es una matriz que contiene todos los elementos especificados, o un campo con un solo valor que coincide con el elemento especificado.

Compatibilidad

Puedes usar $all 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

Para especificar una expresión $all, utiliza el siguiente prototipo:

{ <field>: { $all: [ <value1> , <value2> ... ] } }

Comportamiento

Equivalente a la $and operación

El $all es equivalente a una operación $and de los valores especificados; es decir, la siguiente instrucción:

{ tags: { $all: [ "ssl" , "security" ] } }

es equivalente a:

{ $and: [ { tags: "ssl" }, { tags: "security" } ] }

Arreglo anidado

Cuando se pasa un arreglo de un arreglo anidado (p. ej., [ [ "A" ] ] ), $all coincide con los documentos donde el campo contiene el arreglo anidado como un elemento (p. ej., field: [ [ "A" ], ... ]), o el campo es igual al arreglo anidado (p. ej., field: [ "A" ]).

Por ejemplo, considera la siguiente consulta:

db.articles.find( { tags: { $all: [ [ "ssl", "security" ] ] } } )

La query es equivalente a:

db.articles.find( { $and: [ { tags: [ "ssl", "security" ] } ] } )

que es equivalente a:

db.articles.find( { tags: [ "ssl", "security" ] } )

Por lo tanto, la expresión $all coincide con los documentos donde el campo tags es un arreglo que contiene el arreglo anidado [ "ssl", "security" ] o es un arreglo que es igual al arreglo anidado:

tags: [ [ "ssl", "security" ], ... ]
tags: [ "ssl", "security" ]

Arreglo vacío

Cuando se pasa un arreglo vacío, $all no coincide con ningún documento.

Ejemplos

Los ejemplos en esta sección utilizan la colección inventory que contiene los siguientes documentos:

db.inventory.insertMany ( [
   {
      _id: ObjectId("5234cc89687ea597eabee675"),
      code: "xyz",
      tags: [ "school", "book", "bag", "headphone", "appliance" ],
      qty: [
            { size: "S", num: 10, color: "blue" },
            { size: "M", num: 45, color: "blue" },
            { size: "L", num: 100, color: "green" }
         ]
   }
   {
      _id: ObjectId("5234cc8a687ea597eabee676"),
      code: "abc",
      tags: [ "appliance", "school", "book" ],
      qty: [
            { size: "6", num: 100, color: "green" },
            { size: "6", num: 50, color: "blue" },
            { size: "8", num: 100, color: "brown" }
         ]
   }
   {
      _id: ObjectId("5234ccb7687ea597eabee677"),
      code: "efg",
      tags: [ "school", "book" ],
      qty: [
            { size: "S", num: 10, color: "blue" },
            { size: "M", num: 100, color: "blue" },
            { size: "L", num: 100, color: "green" }
         ]
   }
   {
      _id: ObjectId("52350353b2eff1353b349de9"),
      code: "ijk",
      tags: [ "electronics", "school" ],
      qty: [
            { size: "M", num: 100, color: "green" }
         ]
   }
] )

Utilice $all para hacer coincidir valores

La siguiente operación utiliza el operador $all para consultar la colección inventory en busca de documentos donde el valor del campo tags es un arreglo cuyos elementos incluyen appliance, school y book:

db.inventory.find( { tags: { $all: [ "appliance", "school", "book" ] } } )

El query anterior devuelve los siguientes documentos:

{
   _id: ObjectId("5234cc89687ea597eabee675"),
   code: "xyz",
   tags: [ "school", "book", "bag", "headphone", "appliance" ],
   qty: [
          { size: "S", num: 10, color: "blue" },
          { size: "M", num: 45, color: "blue" },
          { size: "L", num: 100, color: "green" }
        ]
}
{
   _id: ObjectId("5234cc8a687ea597eabee676"),
   code: "abc",
   tags: [ "appliance", "school", "book" ],
   qty: [
          { size: "6", num: 100, color: "green" },
          { size: "6", num: 50, color: "blue" },
          { size: "8", num: 100, color: "brown" }
        ]
}

Usa $all con $elemMatch

Si el campo contiene un arreglo de documentos, puedes usar $all con el operador $elemMatch.

La siguiente operación consulta la colección inventory para documentos en que el valor del campo qty es un arreglo cuyos elementos coinciden con los criterios de $elemMatch:

db.inventory.find( {
                     qty: { $all: [
                                    { "$elemMatch" : { size: "M", num: { $gt: 50} } },
                                    { "$elemMatch" : { num : 100, color: "green" } }
                                  ] }
                   } )

La query devuelve los siguientes documentos:

{
   _id: ObjectId("5234ccb7687ea597eabee677"),
   code: "efg",
   tags: [ "school", "book"],
   qty: [
      { size: "S", num: 10, color: "blue" },
      { "size: "M", num: 100, color: "blue" },
      { size: "L", num: 100, color: "green" }
   ]
}
{
   _id: ObjectId("52350353b2eff1353b349de9"),
   code: "ijk",
   tags: [ "electronics", "school" ],
   qty: [
      { size: "M", num: 100, color: "green" }
   ]
}

El operador $all existe para brindar soporte a las queries en arreglos. Pero puedes usar el operador $all para seleccionar un elemento que no sea un arreglo field, como en el siguiente ejemplo:

db.inventory.find( { "qty.num": { $all: [ 50 ] } } )

Sin embargo, usa el siguiente formulario para express la misma query:

db.inventory.find( { "qty.num" : 50 } )

Ambas queries seleccionarán todos los documentos en la colección inventory en que el valor del campo num sea igual a 50.

Nota

En la mayoría de los casos, MongoDB no trata los arreglos como conjuntos. Este operador constituye una excepción destacada a este enfoque.

Ejemplos adicionales

Para obtener más ejemplos sobre la consulta de arreglos, consulte:

Para obtener ejemplos adicionales sobre query, consulta Documentos de query.

Tip

db.collection.find()

Volver

Arreglos

Next

$elemMatch

En esta página