Definición
Devuelve un arreglo de los elementos únicos en los valores del arreglo en una ventana.
Nuevo en la versión 8.1.
Nota
Desambiguación
Esta página describe $setUnion cuando se utiliza como función de ventana.
También puede usar $setUnion en estos otros contextos:
$setUnion (accumulator), que devuelve un único arreglo de los elementos únicos en los valores del arreglo en un grupo de documentos.$setUnion (expression), que combina dos o más arreglos en un único arreglo de elementos únicos.
Sintaxis
{ $setWindowFields: { ... output: { <field>: { $setUnion: <array field> } } }}Comportamiento
$setUnion realiza operaciones de conjuntos en arreglos, tratando los arreglos como conjuntos. Si un arreglo contiene entradas duplicadas, $setUnion ignora las entradas duplicadas. $setUnion ignora el orden de los elementos.
$setUnion filtra los duplicados en su resultado para producir un arreglo que contenga solo entradas únicas. El orden de los elementos en el arreglo de salida no está especificado.
Si un conjunto contiene un elemento de arreglo anidado, $setUnion no desciende en el arreglo anidado, sino que evalúa el arreglo a nivel superior.
Para ver cómo $setUnion trata los elementos de arreglo anidados, consulte los ejemplos en la sección $setUnion (expression).
Los argumentos que son null o se evalúan como null se incluyen en los resultados. Los argumentos que hacen referencia a un campo que falta no se incluyen en los resultados.
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 $setWindowFields para mostrar cómo los géneros en la filmografía de un director se acumulan con el tiempo. Cada documento recibe los géneros únicos desde la película más antigua hasta la película actual.
db.movies.aggregate( [ { $match: { directors: "Christopher Nolan" } }, { $setWindowFields: { sortBy: { year: 1 }, output: { genresSoFar: { $setUnion: "$genres", window: { documents: [ "unbounded", "current" ] } } } } }, { $project: { _id: 0, title: 1, year: 1, genres: 1, genresSoFar: 1 } }] )El pipeline anterior:
Utiliza
$matchpara usar filtro las películas dirigidas por Christopher Nolan.Utiliza
$setWindowFieldspara ordenar películas poryeary aplicar$setUnional campogenresen una ventana de documentos de[ "unbounded", "current" ]. El campogenresSoFarcontiene los géneros únicos de la primera película en el orden de clasificación hasta la película actual.Utiliza
$projectpara incluirtitle,year,genresygenresSoFaren la salida.
El arreglo genresSoFar crece a medida que cada película aporta géneros que aún no han aparecido. The Dark Knight Rises y Interstellar no añaden nuevos géneros, por lo que sus ventanas devuelven el mismo conjunto que Inception.