Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

$addToSet (operador acumulador )

$addToSet

Retorna uma array de valores exclusivos para uma expressão avaliada em documentos em um grupo. A ordem dos elementos na array não é especificada.

$addToSet está disponível nestes estágios:

Observação

Desambiguação

Esta página descreve $addToSet quando usado como um acumulador. Acumuladores retornam um único valor agregado, como soma, máximo ou mínimo, em um grupo de documentos de entrada.

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

{ $addToSet: <expression> }

Para mais informações sobre expressões, consulte Expressões.

Se o valor da expressão for uma array, $addToSet a anexará inteira como um único elemento.

Se o valor da expressão for um documento, o MongoDB determinará que o documento é duplicado se outro documento na array corresponder exatamente ao documento adicionado. Especificamente, o documento existente tem exatamente os mesmos campos e valores na mesma ordem.

$addToSet não é possível escrever arquivos temporários no disco. O parâmetro de servidor internalQueryMaxAddToSetBytes controla o limite de memória $addToSet e, se a array acumulada exceder esse limite, o MongoDB retornará um erro mesmo quando allowDiskUse estiver true. Por padrão, o parâmetro é 104857600 bytes (100 megabytes). Você pode aumentar o limite em tempo de execução com o comandosetParameter.

Para obter mais informações sobre restrições de memória de agregação , consulte Limites de aggregation pipeline.

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.

A operação a seguir agrupa filmes por diretor e usa o acumulador $addToSet para coletar os gêneros únicos em que cada diretor atuou. Para melhorar a legibilidade, o pipeline limita os resultados aos cinco primeiros diretores em ordem alfabética.

db.movies.aggregate( [ { $unwind: "$directors" }, { $unwind: "$genres" }, { $group: { _id: "$directors", genres: { $addToSet: "$genres" } } }, { $sort: { _id: 1 } }, { $limit: 5 }] )

Esse pipeline retorna esses resultados:

[ { _id: 'A. Dean Bell', genres: [ 'Crime', 'Drama' ] }, { _id: 'A. Karunakaran', genres: [ 'Romance' ] }, { _id: 'A. Vanichkin', genres: [ 'Animation', 'Fantasy' ] }, { _id: 'A.J. Edwards', genres: [ 'Biography', 'Drama', 'History' ] }, { _id: 'A.R. Murugadoss', genres: [ 'Drama', 'Sci-Fi', 'Thriller', 'Action', 'Mystery' ] }]