Definición
Devuelve un arreglo con todos los valores que se obtienen al aplicar una expresión a cada documento de un grupo.
El acumulador $push está disponible en estas etapas:
Nota
Desambiguación
Esta página describe $push cuando se utiliza como acumulador. Los acumuladores devuelven un valor agregado en un grupo de documentos de entrada.
También puede usar $push en estos otros contextos:
$push (window function), que se utiliza en la etapa$setWindowFieldspara devolver un arreglo de todos los valores de los documentos en una ventana determinada.$push (update operator), que añade un valor a un campo de arreglo en un documento.
Sintaxis
{ $push: <expression> }Para obtener más información sobre las expresiones, consulta Expresiones.
Comportamiento
Al usar $push como acumulador, el orden de los documentos que ingresan al pipeline determina el orden de los documentos en el arreglo de salida. Para garantizar un orden definido, coloque una etapa $sort antes de la etapa $group.
Limitaciones
El acumulador $push no puede guardar archivos temporales en el disco. El parámetro de servidor internalQueryMaxPushBytes controla el lÃmite de memoria $push y, si el arreglo acumulado supera ese lÃmite, MongoDB devuelve un error incluso cuando allowDiskUse es true. Por defecto, el parámetro es 104857600 bytes (100 megabytes). Puede aumentar el lÃmite en tiempo de ejecución con el comando setParameter, hasta un máximo de 2147483647 bytes.
Para obtener más información sobre las restricciones de memoria de agregación, consulte LÃmites de la pipeline de agregación.
Ejemplo
Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.
La siguiente operación agrupa las pelÃculas por director y utiliza el acumulador $push para recopilar el género primario de cada pelÃcula dirigida por ese director.
db.movies.aggregate( [ { $match: { year: { $gte: 2010, $lte: 2015 }, genres: { $exists: true, $ne: [] }, directors: { $exists: true, $ne: [] } } }, { $unwind: "$directors" }, { $group: { _id: "$directors", genres: { $push: { $first: "$genres" } } } }, { $sort: { _id: 1 } }, { $limit: 5 }] )El pipeline anterior:
Utiliza
$matchpara usar filtro pelÃculas de 2010-2015 que tienen información de género y director.Utiliza
$unwindpara crear un documento independiente para cada director en el arreglodirectors.Agrupa los documentos resultantes por director y utiliza
$pushpara recopilar el género principal de cada pelÃcula.Ordena los resultados por nombre de director en orden alfabético.
Limita la salida a cinco directores.
En la salida, A.R. Murugadoss tiene a Action listado dos veces porque dirigieron dos pelÃculas con Action como género primario. Esto demuestra que $push incluye valores duplicados, a diferencia de $addToSet, que devuelve un arreglo de valores únicos.