$addToSet (función de ventana)

Definición

$addToSet

Devuelve una matriz con todos los valores únicos de una ventana específica.

El orden de los elementos en el arreglo devuelto es indefinido.

Sintaxis

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $addToSet: <expression>
         }
      }
   }
}

Comportamiento

Si el valor de la expresión es una matriz, $addToSet agrega toda la matriz como un solo elemento.

Si el valor de la expresión es un documento, MongoDB determina que el documento es un duplicado si otro documento del arreglo coincide exactamente con el documento que se va a agregar. En concreto, el documento existente tiene exactamente los mismos campos y valores en el mismo orden.

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 $addToSet para mostrar cómo se acumulan los géneros únicos en las películas a lo largo del tiempo. Las películas se ordenan alfabéticamente por título, y la función de ventana registra todos los géneros únicos que han aparecido en las películas desde el inicio de la configuración de resultados hasta la película actual, inclusive.

db.movies.aggregate( [
   {
      $match: {
         year: 2002,
         genres: { $exists: true, $ne: [] }
      }
   },
   {
      $group: {
         _id: { year: "$year", title: "$title", genre: { $first: "$genres" } },
      }
   },
   {
      $setWindowFields: {
         sortBy: { "_id.title": 1 },
         output: {
            genresSeenSoFar: {
               $addToSet: "$_id.genre",
               window: {
                  documents: [ "unbounded", "current" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         year: "$_id.year",
         title: "$_id.title",
         genre: "$_id.genre",
         genresSeenSoFar: 1,
         uniqueGenreCount: { $size: "$genresSeenSoFar" }
      }
   },
   {
      $limit: 8
   }
] )

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

En el ejemplo:

• La etapa $match filtra las películas de 2002 con información de género.

• Los grupos de la etapa $group se ordenan por año, título y el primer género en la matriz genres.

• La etapa $setWindowFields utiliza $addToSet con una ventana de unbounded a current para acumular géneros únicos desde el inicio del conjunto de resultados hasta el documento actual.

• La etapa $project remodela la salida y calcula uniqueGenreCount para mostrar cómo crece el tamaño del conjunto.

• La etapa $limit restringe la salida a documentos 8.

El resultado demuestra cómo $addToSet acumula géneros únicos en los documentos. Observe que genresSeenSoFar pasa del género 1 al género 7 a medida que cada película añade su género al conjunto. El séptimo documento ('3 Extremes II') tiene el mismo uniqueGenreCount que el sexto porque su género (Terror) ya estaba en el conjunto. Esto demuestra que $addToSet solo añade valores únicos e ignora los duplicados.