Definición
Devuelve un arreglo de todos los valores únicos de una ventana específica.
El orden de los elementos en el arreglo devuelto es indefinido.
Nota
Desambiguación
Esta página describe $addToSet cuando se utiliza como función de ventana.
También puede usar $addToSet en estos otros contextos:
$addToSet (accumulator), que devuelve un único valor agregado basado en un número variable de documentos de entrada.$addToSet (update operator), que añade elementos a un campo de arreglo en un documento.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $addToSet: <expression> } } }}Comportamiento
Si el valor de la expresión es un arreglo, $addToSet añade todo el arreglo como un único 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 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 $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 rastrea todos los géneros únicos que han aparecido en películas desde el principio del conjunto de resultados hasta e incluyendo la película actual.
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 }] )En el ejemplo:
La etapa
$matchfiltro las películas de 2002 con información de género.La etapa
$groupagrupa por año, título y el primer género en el arreglogenres.La etapa
$setWindowFieldsutiliza$addToSetcon una ventana deunboundedacurrentpara acumular géneros únicos desde el principio del conjunto de resultados hasta el documento actual.La etapa
$projectremodela la salida y calculauniqueGenreCountpara mostrar cómo crece el tamaño del conjunto.La etapa
$limitlimita la salida a 8 documentos.
La salida demuestra cómo $addToSet acumula géneros únicos en todos los documentos. Observe que genresSeenSoFar crece de 1 género a 7 géneros 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.