/ /

Expressões

Página inicial do Docs

/ /

Linguagem de query

Expressões

Página inicial do Docs

$setUnion

Definição

Obtém duas ou mais arrays e retorna uma única array contendo os elementos exclusivos que aparecem em qualquer array de entrada. $setUnion pode ser utilizado como um acumulador de agregação ou um operador de array.

Acumulador de agregação

$setUnion

$setUnion está disponível como acumulador nestes estágios:

Sintaxe

Quando usado como acumulador de agregação, $setUnion tem a seguinte sintaxe:

{ $setUnion: "<array field>" }

Comportamento

$setUnion executa operação de conjunto em arrays, tratando arrays como conjuntos. Se uma array contiver entradas duplicadas, $setUnion ignora essas entradas. $setUnion ignora a ordem dos elementos.

$setUnion filtra duplicatas em seu resultado para gerar uma matriz que contém apenas entradas exclusivas. A ordem dos elementos na matriz de saída não é especificada.

Se um conjunto contiver um elemento de array aninhada, $setUnion não desce para a array aninhada, mas avalia a array no nível superior.

Os argumentos que são null ou que resultam em null são incluídos nos resultados. Os argumentos que se referem a um campo ausente não são incluídos nos resultados.

Exemplo

Crie uma coleção denominada sales com os seguintes documentos:

db.sales.insertMany( [
   {
     _id: 1,
     items: [ "laptop", "tablet" ],
     location: "NYC"
   },
   {
     _id: 2,
     items: [ "phone", "tablet" ],
     location: "NYC"
   },
   {
     _id: 3,
     location: "NYC"
   },
   {
     _id: 4,
     items: [ "desktop", { "accessories": [ "mouse", "keyboard"] } ],
     location: "NYC"
   }
] )

Este exemplo mostra como você pode utilizar o $setUnion como acumulador. Este exemplo acumula todos os elementos exclusivos nas arrays items ao agrupar no campo location :

db.sales.aggregate( [
   {
      $group: {
         _id: "$location",
         array: { "$setUnion": "$items" }
      }
   }
] )

A operação retorna o seguinte resultado:

[
   {
      "_id": "NYC",
      "array": [
          "laptop", "tablet", "phone", "desktop", { "accessories": [ "mouse", "keyboard"] }
      ]
   }
]

Operador de array

$setUnion

Sintaxe

Se utilizado como operador de array, $setUnion tem a seguinte sintaxe:

{
   $setUnion: [ <expression1>, <expression2>, ... ]
}

Comportamento

$setUnion filtra duplicatas em seu resultado para gerar uma matriz que contém apenas entradas exclusivas. A ordem dos elementos na matriz de saída não é especificada.

Os argumentos podem ser qualquer expressão válida, desde que cada um deles resolva para uma array. Para mais informações sobre expressões, consulte Expressões.

Se um conjunto contiver um elemento de array aninhada, $setUnion não desce para a array aninhada, mas avalia a array no nível superior.

Exemplo

Resultado

Notas

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

[ "a", "c", "b" ]

Todos os elementos de ambas as arrays são combinados e os elementos duplicados removidos.

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

[ "a", "c", "b" ]

Todos os elementos de ambas as arrays são combinados e os elementos duplicados removidos.

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

[ "a", "b" ]

Todos os elementos de ambas as arrays são combinados e os elementos duplicados removidos.

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

[ "a", "b", [ "a", "b" ] ]

O resultado inclui "a" e "b" como elementos de string individuais e a array [ "a", "b" ] como um elemento único.

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

[ "a", "b" ]

O resultado consiste nos elementos exclusivos na segunda array porque a primeira array está vazia.

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

[ "a", "b" ]

Todos os elementos de ambas as arrays são combinados e os elementos duplicados removidos.

Exemplo

Considere uma coleção flowers com os seguintes documentos:

db.flowers.insertMany( [
   { "_id" : 1, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ "rose", "orchid" ] },
   { "_id" : 2, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ "orchid", "rose", "orchid" ] },
   { "_id" : 3, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ "rose", "orchid", "jasmine" ] },
   { "_id" : 4, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ "jasmine", "rose" ] },
   { "_id" : 5, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ ] },
   { "_id" : 6, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ [ "rose" ], [ "orchid" ] ] },
   { "_id" : 7, "flowerFieldA" : [ "rose", "orchid" ], "flowerFieldB" : [ [ "rose", "orchid" ] ] },
   { "_id" : 8, "flowerFieldA" : [ ], "flowerFieldB" : [ ] },
   { "_id" : 9, "flowerFieldA" : [ ], "flowerFieldB" : [ "rose" ] }
] )

A operação a seguir utiliza o operador $setUnion para retornar uma array de elementos encontrados na array flowerFieldA, na array flowerFieldB ou em ambas:

db.flowers.aggregate(
   [
     { $project: { flowerFieldA:1, flowerFieldB: 1, allValues: { $setUnion: [ "$flowerFieldA", "$flowerFieldB" ] }, _id: 0 } }
   ]
)

A operação retorna os seguintes resultados:

{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ "rose", "orchid" ], "allValues": [ "orchid", "rose" ] }
{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ "orchid", "rose", "orchid" ], "allValues": [ "orchid", "rose" ] }
{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ "rose", "orchid", "jasmine" ], "allValues": [ "orchid", "rose", "jasmine" ] }
{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ "jasmine", "rose" ], "allValues": [ "orchid", "rose", "jasmine" ] }
{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ ], "allValues": [ "orchid", "rose" ] }
{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ [ "rose" ], [ "orchid" ] ], "allValues": [ "orchid", "rose", [ "rose" ], [ "orchid" ] ] }
{ "flowerFieldA": [ "rose", "orchid" ], "flowerFieldB": [ [ "rose", "orchid" ] ], "allValues": [ "orchid", "rose", [ "rose", "orchid" ] ] }
{ "flowerFieldA": [ ], "flowerFieldB": [ ], "allValues": [ ] }
{ "flowerFieldA": [ ], "flowerFieldB": [ "rose" ], "allValues": [ "rose" ] }

Limitações

$setUnion suporta apenas arrays e expressões que resolvem para uma array.
$setUnion não garante a ordem dos elementos na matriz de saída.

Saiba mais

Voltar

$setIsSubset

$shift