Definición
Devuelve un arreglo de todos los valores, incluidos los duplicados, que resultan de aplicar una expresión a cada documento en una ventana.
Nota
Desambiguación
Esta página describe $push cuando se utiliza como función de ventana.
También puede usar $push en estos otros contextos:
$push (accumulator), que devuelve el arreglo resultante después de aplicar una expresión a cada documento en un grupo.$push (update operator), que añade un valor a un campo de arreglo en un documento.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $push: <expression> } } }}Comportamiento
$push incluye todos los valores de la ventana, incluidos los duplicados. El orden de los elementos en el arreglo de salida corresponde al orden de clasificación especificado en el $setWindowFields sortBy campo.
El parámetro de servidor internalQueryMaxPushBytes limita la cantidad de memoria que puede utilizar el arreglo acumulado. Para aprender más, consulta $push Límite de memoria del acumulador.
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.
Este ejemplo utiliza la función de ventana $push para compilar una lista continua de géneros en películas de 2002. Para cada película, $push agrega el género primario de la película a genresSeenSoFar, conservando todos los valores, incluidos los duplicados.
db.movies.aggregate( [ { $match: { year: 2002, genres: { $exists: true, $ne: [] } } }, { $addFields: { primaryGenre: { $first: "$genres" } } }, { $setWindowFields: { sortBy: { title: 1 }, output: { genresSeenSoFar: { $push: "$primaryGenre", window: { documents: [ "unbounded", "current" ] } } } } }, { $project: { _id: 0, genresSeenSoFar: "$genresSeenSoFar", year: "$year", title: "$title", genre: "$primaryGenre", totalGenreCount: { $size: "$genresSeenSoFar" } } }, { $limit: 8 }] )En el ejemplo:
La etapa
$matchfiltro las películas de 2002 con información de género.La etapa
$addFieldsañade un campoprimaryGenreque contiene el primer elemento en el arreglogenres.La etapa
$setWindowFieldsutiliza$pushcon una ventana deunboundedacurrentpara acumular todos los géneros desde el principio del conjunto de resultados hasta el documento actual.La etapa
$projectremodela la salida y calculatotalGenreCountpara mostrar cómo crece el arreglo con cada documento.La
$limitetapa restringe la salida a 8 documentos para mejorar la legibilidad.
totalGenreCount aumenta en uno con cada documento. El séptimo documento ('3 Extremes II') tiene el género Horror, que ya estaba en el arreglo, por lo que Horror aparece dos veces en genresSeenSoFar. Esto demuestra que $push incluye valores duplicados, a diferencia de $addToSet, que solo agrega valores únicos.