Definición
Toma dos o más arreglos y devuelve un solo arreglo que contiene los elementos únicos que aparecen en cualquier arreglo de entrada.
Nota
Desambiguación
Esta página describe $setUnion cuando se utiliza como una expresión, que combina dos o más arreglos en un único arreglo de elementos únicos.
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 (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: [ <expression1>, <expression2>, ... ]}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.
Los argumentos pueden ser cualquier expresión válida, siempre que cada uno se resuelva en un arreglo. Para obtener más información sobre las expresiones, consulta Expresiones.
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.
La siguiente tabla muestra los resultados que $setUnion devuelve para diferentes entradas:
Ejemplo | Resultado | notas |
|---|---|---|
| | Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados. |
| | Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados. |
| | Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados. |
| | El resultado incluye |
| | El resultado consiste en los elementos únicos del segundo arreglo porque el primer arreglo está vacío. |
| | Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados. |
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 combinar los arreglos cast y directors en un único arreglo de las personas acreditadas en cada película:
db.movies.aggregate( [ { $match: { title: { $in: [ "Annie Hall", "Reservoir Dogs" ] } } }, { $project: { _id: 0, title: 1, cast: 1, directors: 1, keyContributors: { $setUnion: [ "$cast", "$directors" ] } } }, { $sort: { title: 1 } }] )El pipeline anterior:
Utiliza
$matchpara filtrar dos películas.Utiliza
$projectcon$setUnionpara combinarcastydirectorsen el campokeyContributors.Utiliza
$sortpara ordenar los resultados portitle.
Para Annie Hall, Woody Allen aparece tanto en cast como en directors pero aparece solo una vez en keyContributors, porque $setUnion remueve los elementos duplicados.
Limitaciones
$setUnionsolo admite arreglos y expresiones que se resuelven en un arreglo.