/ /

$addToSet (função de janela)

Definição

$addToSet

Retorna uma matriz de todos os valores exclusivos de uma janela específica.

A ordem dos elementos na array que retorna não é especificada.

Observação

Desambiguação

Esta página descreve $addToSet quando usado como uma função de janela.

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

$addToSet (accumulator), que retorna um único valor agregado com base em um número variável de documentos de entrada.
$addToSet (update operator), que adiciona elementos a um campo de array em um documento.

Sintaxe

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $addToSet: <expression>
         }
      }
   }
}

Comportamento

Se o valor da expressão for uma array, $addToSet anexará a array 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.

Exemplo

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações 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 a função de janela $addToSet para mostrar como gêneros únicos se acumulam nos filmes ao longo do tempo. Os filmes são classificados alfabeticamente por título, e a função da janela rastreia todos os gêneros únicos que apareceram nos filmes desde o início da configuração do resultado até o filme atual.

db.movies.aggregate( [
   {
      $match: {
         year: 2002,
         genres: { $exists: true, $ne: [] }
      }
   },
   {
      $group: {
         _id: { year: "$year", title: "$title", genre: { $first: "$genres" } },
      }
   },
   {
      $setWindowFields: {
         sortBy: { "_id.title": 1 },
         output: {
            genresSeenSoFar: {
               $addToSet: "$_id.genre",
               window: {
                  documents: [ "unbounded", "current" ]
               }
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         year: "$_id.year",
         title: "$_id.title",
         genre: "$_id.genre",
         genresSeenSoFar: 1,
         uniqueGenreCount: { $size: "$genresSeenSoFar" }
      }
   },
   {
      $limit: 8
   }
] )

[
  {
    genresSeenSoFar: [ 'Short' ],
    year: 2002,
    title: '10 Minutes',
    genre: 'Short',
    uniqueGenreCount: 1
  },
  {
    genresSeenSoFar: [ 'Short', 'Drama' ],
    year: 2002,
    title: '10,000 Black Men Named George',
    genre: 'Drama',
    uniqueGenreCount: 2
  },
  {
    genresSeenSoFar: [ 'Short', 'Action', 'Drama' ],
    year: 2002,
    title: '2009 Loseuteu maemorijeu',
    genre: 'Action',
    uniqueGenreCount: 3
  },
  {
    genresSeenSoFar: [ 'Action', 'Short', 'Biography', 'Drama' ],
    year: 2002,
    title: '24 Hour Party People',
    genre: 'Biography',
    uniqueGenreCount: 4
  },
  {
    genresSeenSoFar: [ 'Action', 'Short', 'Biography', 'Drama', 'Crime' ],
    year: 2002,
    title: '25th Hour',
    genre: 'Crime',
    uniqueGenreCount: 5
  },
  {
    genresSeenSoFar: [ 'Action', 'Short', 'Biography', 'Drama', 'Crime', 'Horror' ],
    year: 2002,
    title: '28 Days Later...',
    genre: 'Horror',
    uniqueGenreCount: 6
  },
  {
    genresSeenSoFar: [ 'Action', 'Short', 'Biography', 'Drama', 'Crime', 'Horror' ],
    year: 2002,
    title: '3 Extremes II',
    genre: 'Horror',
    uniqueGenreCount: 6
  },
  {
    genresSeenSoFar: [
      'Comedy',
      'Drama',
      'Action',
      'Short',
      'Horror',
      'Biography',
      'Crime'
    ],
    year: 2002,
    title: '40 Days and 40 Nights',
    genre: 'Comedy',
    uniqueGenreCount: 7
  }
]

No exemplo:

O estágio $match filtra para filmes de 2002 com informações de gênero.
O estágio $group agrupa por ano, título e o primeiro gênero na array genres.
O estágio $setWindowFields usa $addToSet com uma janela de unbounded a current para acumular gêneros únicos desde o início da definição de resultados até o documento atual.
O estágio $project remodela a saída e calcula uniqueGenreCount para mostrar como o tamanho do conjunto cresce.
O estágio $limit restringe a saída para documentos 8.

A saída demonstra como $addToSet acumula gêneros únicos entre documentos. Observe que genresSeenSoFar cresce de 1 gênero para 7 gêneros à medida que cada filme adiciona seu gênero ao conjunto. O sétimo documento ('3 Extremes II') tem o mesmo uniqueGenreCount do sexto porque seu gênero (Horror) já estava no conjunto. Isso demonstra que $addToSet apenas adiciona valores únicos e ignora duplicatas.

Voltar

Funções de janela

$avg