$push (operador de actualización)

Definición

$push

El operador $push añade un valor especificado a un arreglo.

Compatibilidad

Puedes usar $push 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 $push tiene la forma:

{ $push: { <field1>: <value1>, ... } }

Para especificar un <field> en un documento incrustado o en un arreglo, utiliza notación de puntos.

Comportamiento

A partir de MongoDB 5.0, los operadores de actualización procesan los campos de documentos con nombres basados en cadenas en orden lexicográfico. Los campos con nombres numéricos se procesan en orden numérico. Consulta Comportamiento del operador de actualización para obtener más información.

Si el campo está ausente en el documento que se va a actualizar, $push añade el campo de arreglo con el valor como su elemento.

Si el campo no es un arreglo, la operación fallará.

Si el valor es un arreglo, $push añade todo el arreglo como un único elemento. Para añadir cada elemento del valor por separado, utiliza el modificador $each con $push. Para un ejemplo, consulta Agregar un valor a arreglos en múltiples documentos. Para obtener una lista de modificadores disponibles para $push, consulta Modificadores.

A partir de MongoDB 5.0, mongod ya no genera un error cuando utiliza un operador de actualización como $push con una expresión de operando vacía ( { } ). Una actualización vacía no produce cambios y no genera ninguna entrada en el oplog (lo que significa que la operación es una “no-op").

Modifiers

Puedes utilizar el operador $push con los siguientes modificadores:

Cuando se utiliza con modificadores, el operador $push tiene esta forma:

{ $push: { <field1>: { <modifier1>: <value1>, ... }, ... } }

El procesamiento de la operación $push con modificadores se realiza en el siguiente orden, independientemente del orden en que aparezcan los modificadores:

1. Actualiza el arreglo para añadir elementos en la posición correcta.

2. Aplica la ordenación, si está especificada.

3. Divide el arreglo, si está especificado.

4. Almacena el arreglo.

Ejemplos

Crear la colección students:

db.students.insertOne( { _id: 1, scores: [ 44, 78, 38, 80 ] } )

db.students.updateOne(
   { _id: 1 },
   { $push: { scores: 89 } }
)

{ _id: 1, scores: [ 44, 78, 38, 80, 89 ] }

db.students.insertMany( [
   { _id: 2, scores: [ 45, 78, 38, 80, 89 ] } ,
   { _id: 3, scores: [ 46, 78, 38, 80, 89 ] } ,
   { _id: 4, scores: [ 47, 78, 38, 80, 89 ] }
] )

db.students.updateMany(
   { },
   { $push: { scores: 95 } }
)

db.students.find()

[
   { _id: 1, scores: [ 44, 78, 38, 80, 89, 95 ] },
   { _id: 2, scores: [ 45, 78, 38, 80, 89, 95 ] },
   { _id: 3, scores: [ 46, 78, 38, 80, 89, 95 ] },
   { _id: 4, scores: [ 47, 78, 38, 80, 89, 95 ] }
]

db.students.updateOne(
   { name: "joe" },
   { $push: { scores: { $each: [ 90, 92, 85 ] } } }
)

db.students.insertOne(
   {
      "_id" : 5,
      "quizzes" : [
         { "wk": 1, "score" : 10 },
         { "wk": 2, "score" : 8 },
         { "wk": 3, "score" : 5 },
         { "wk": 4, "score" : 6 }
      ]
   }
)

db.students.updateOne(
   { _id: 5 },
   {
     $push: {
       quizzes: {
          $each: [ { wk: 5, score: 8 }, { wk: 6, score: 7 }, { wk: 7, score: 6 } ],
          $sort: { score: -1 },
          $slice: 3
       }
     }
   }
)

{
  "_id" : 5,
  "quizzes" : [
     { "wk" : 1, "score" : 10 },
     { "wk" : 2, "score" : 8 },
     { "wk" : 5, "score" : 8 }
  ]
}