Definición
Devuelve un arreglo de los elementos únicos de los valores de los arreglos de un grupo de documentos.
Nuevo en la versión 8.1.
El acumulador $setUnion está disponible en estas etapas:
Nota
Desambiguación
Esta página describe $setUnion cuando se utiliza como acumulador. Los acumuladores devuelven un único valor agregado en un grupo de documentos de entrada.
También puede usar $setUnion en estos otros contextos:
$setUnion (expression), que combina dos o más arreglos en un único arreglo de elementos únicos.$setUnion (window function), que se utiliza en la$setWindowFieldsetapa para devolver un único arreglo de los elementos únicos en los valores del arreglo en una ventana.
Sintaxis
{ $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 $setUnion para devolver los géneros distintos en los que han trabajado tres directores específicos:
db.movies.aggregate( [ { $unwind: "$directors" }, { $match: { directors: { $in: [ "Christopher Nolan", "Sofia Coppola", "Spike Lee" ] } } }, { $group: { _id: "$directors", movieCount: { $sum: 1 }, genres: { $setUnion: "$genres" } } }, { $sort: { _id: 1 } }] )El pipeline anterior:
Limitaciones
$setUnionsolo admite arreglos y expresiones que se resuelven en un arreglo.