/ /

$setUnion (operadores acumuladores)

Definição

$setUnion

Retorna uma array de elementos exclusivos nos valores da array em um grupo de documentos.

Novidades na versão 8.1.

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

Observação

Desambiguação

Esta página descreve $setUnion quando usado como um acumulador. Acumuladores retornam um único valor agregado em um grupo de documentos de entrada.

Você também pode usar $setUnion nestes outros contextos:

$setUnion (expression), que combina dois ou mais arrays em um único array de elementos exclusivos.
$setUnion (window function), que é usado no $setWindowFields estágio para retornar um único array dos elementos exclusivos nos valores do array em uma janela.

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.

Para ver como $setUnion trata elementos de array aninhados, consulte os exemplos na seção $setUnion (expression).

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

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar este conjunto de dados em sua implantação do MongoDB autogerenciado, consulte Carregar o conjunto de dados de amostra. Se você fez alguma modificação nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

Este exemplo usa $setUnion para retornar os gêneros distintos em que três diretores específicos trabalharam:

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 }
   }
] )

[
  {
    _id: 'Christopher Nolan',
    movieCount: 9,
    genres: [
      'Crime',
      'Action',
      'Drama',
      'Sci-Fi',
      'Mystery',
      'Thriller',
      'Adventure'
    ]
  },
  {
    _id: 'Sofia Coppola',
    movieCount: 5,
    genres: [ 'History', 'Romance', 'Drama', 'Biography', 'Comedy', 'Crime' ]
  },
  {
    _id: 'Spike Lee',
    movieCount: 27,
    genres: [
      'Action',
      'Comedy',
      'Drama',
      'Crime',
      'Documentary',
      'Music',
      'Sport',
      'Biography',
      'Romance',
      'History',
      'Mystery'
    ]
  }
]

O pipeline anterior:

Usa $unwind para criar um documento separado para cada crédito de diretor.
Usa $match para filtro três diretores específicos.
Usa $group para agrupar por diretor, contar os filmes com $sum e combinar os genres array de todos os filmes do diretor em um único array de gêneros exclusivos com $setUnion.
Usa $sort para ordenar os resultados pelo nome do diretor.

Limitações

$setUnion suporta apenas arrays e expressões que resolvem para uma array.

Saiba mais

Voltar

$push

$stdDevPop