Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$push (operador de acumulación)

$push

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: <expression> }

Para obtener más información sobre las expresiones, consulta Expresiones.

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.

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.

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 $match para usar filtro películas de 2010-2015 que tienen información de género y director.

  • Utiliza $unwind para crear un documento independiente para cada director en el arreglo directors.

  • Agrupa los documentos resultantes por director y utiliza $push para 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.