/ /

$push (función de ventana)

Definición

$push

Devuelve una matriz con 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 puedes usar $push en estos otros contextos:

$push (accumulator), que devuelve la matriz resultante después de aplicar una expresión a cada documento de un grupo.
$push (update operator), que agrega un valor a un campo de matriz 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 la matriz de salida corresponde al orden de clasificación especificado en el campo $setWindowFields sortBy.

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 su implementación autogestionada de MongoDB, consulte Cargar el conjunto de datos de ejemplo. Si realizó alguna modificación en las bases de datos de ejemplo, es posible que deba eliminarlas y volver a crearlas para ejecutar los ejemplos de esta página.

Este ejemplo utiliza la función de ventana $push para crear una lista acumulativa de géneros en las películas de 2002. Para cada película, $push agrega el género principal 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
   }
] )

[
  {
    genresSeenSoFar: [ 'Short' ],
    year: 2002,
    title: '10 Minutes',
    genre: 'Short',
    totalGenreCount: 1
  },
  {
    genresSeenSoFar: [ 'Short', 'Drama' ],
    year: 2002,
    title: '10,000 Black Men Named George',
    genre: 'Drama',
    totalGenreCount: 2
  },
  {
    genresSeenSoFar: [ 'Short', 'Drama', 'Action' ],
    year: 2002,
    title: '2009 Loseuteu maemorijeu',
    genre: 'Action',
    totalGenreCount: 3
  },
  {
    genresSeenSoFar: [ 'Short', 'Drama', 'Action', 'Biography' ],
    year: 2002,
    title: '24 Hour Party People',
    genre: 'Biography',
    totalGenreCount: 4
  },
  {
    genresSeenSoFar: [ 'Short', 'Drama', 'Action', 'Biography', 'Crime' ],
    year: 2002,
    title: '25th Hour',
    genre: 'Crime',
    totalGenreCount: 5
  },
  {
    genresSeenSoFar: [
      'Short',
      'Drama',
      'Action',
      'Biography',
      'Crime',
      'Horror'
    ],
    year: 2002,
    title: '28 Days Later...',
    genre: 'Horror',
    totalGenreCount: 6
  },
  {
    genresSeenSoFar: [
      'Short',
      'Drama',
      'Action',
      'Biography',
      'Crime',
      'Horror',
      'Horror'
    ],
    year: 2002,
    title: '3 Extremes II',
    genre: 'Horror',
    totalGenreCount: 7
  },
  {
    genresSeenSoFar: [
      'Short',
      'Drama',
      'Action',
      'Biography',
      'Crime',
      'Horror',
      'Horror',
      'Comedy'
    ],
    year: 2002,
    title: '40 Days and 40 Nights',
    genre: 'Comedy',
    totalGenreCount: 8
  }
]

En el ejemplo:

La etapa $match filtra las películas de 2002 con información de género.
La etapa $addFields agrega un campo primaryGenre que contiene el primer elemento en el array genres.
La etapa $setWindowFields utiliza $push con una ventana unbounded a current para acumular todos los géneros desde el inicio del conjunto de resultados hasta el documento actual.
La etapa $project remodela la salida y calcula totalGenreCount para mostrar cómo crece la matriz con cada documento.
La etapa $limit restringe la salida a documentos 8 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 array, por lo que Horror aparece dos veces en genresSeenSoFar. Esto demuestra que $push incluye valores duplicados, a diferencia de $addToSet, que solo añade valores únicos.

Obtén más información

Volver

$percentile

$setUnion