$setUnion (União de Conjuntos)

Última atualização: 2026-10-09

$setUnion (União de Conjuntos)

$setUnion mescla todos os arrays de entrada e deduplica os elementos, retornando a união. Usos típicos: combinar tags de várias fontes ou agregar IDs de leads coletados por canais diferentes. Aceita dois ou mais arrays, e elementos null são ignorados. O resultado não tem ordem garantida, e duplicatas colapsam em uma. Diferente de $concatArrays, que mantém duplicatas e preserva a ordem de concatenação, $setUnion segue a semântica de conjunto e deduplica.

📝 Sintaxe

{ $setUnion: [ <array1>, <array2>, ... ] }

⚙️ Parâmetros

Retorno：Uma mesclagem sem duplicatas de todos os elementos de entrada

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $setUnion: mesclar dois conjuntos de tags
db.products.aggregate([
  { $project: {
      allTags: { $setUnion: ['$tags', '$extraTags'] }
  } }
])

Saída：

{ '_id': 1, 'allTags': [ 'a', 'b', 'c', 'd' ] }

📌 Notas

• O resultado é deduplicado sem ordem garantida
• Elementos null são ignorados
• Use $concatArrays quando duplicatas e ordem precisarem ser mantidas

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós