Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$setUnion (expresión)

$setUnion

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: [ <expression1>, <expression2>, ... ]}

$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
{ $setUnion: [ [ "a", "c" ], [ "a", "b" ]] }
[ "a", "c", "b" ]

Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados.

{ $setUnion: [ [ "a", "c" ], [ "a", "b", "c" ]] }
[ "a", "c", "b" ]

Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados.

{ $setUnion: [ [ "a", "b", "a" ], [ "b", "a" ]] }
[ "a", "b" ]

Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados.

{ $setUnion: [ [ "a", "b" ], [ [ "a", "b" ] ]] }
[ "a", "b", [ "a", "b" ] ]

El resultado incluye "a" y "b" como elementos de string individuales y el arreglo [ "a", "b" ] como un elemento único.

{ $setUnion: [ [ ], [ "a", "b" ]] }
[ "a", "b" ]

El resultado consiste en los elementos únicos del segundo arreglo porque el primer arreglo está vacío.

{ $setUnion: [ [ "a", "a" ], [ "a", "b" ]] }
[ "a", "b" ]

Todos los elementos de ambos arreglos se combinan y se eliminan los elementos duplicados.

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 $match para filtrar dos películas.

  • Utiliza $project con $setUnion para combinar cast y directors en el campo keyContributors.

  • Utiliza $sort para ordenar los resultados por title.

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.

  • $setUnion solo admite arreglos y expresiones que se resuelven en un arreglo.