$mergeObjects (expressão)

Definição

$mergeObjects

Mescle uma array de documentos em um único documento.

Sintaxe

Quando utilizado como uma expressão, $mergeObjects tem esta sintaxe:

{ $mergeObjects: <expression> }

O operando <expression> pode ser:

• Uma única expressão que avalia para uma array de documentos para mesclar. Por exemplo , $blogPosts onde o campo de documento blogPosts contém uma array de documentos.

• Uma array de expressões, cada uma das quais avalia para um documento. Por exemplo , [ "$doc1", "$doc2", "$doc3" ] onde cada campo de documento contém um único documento.

Comportamento

$mergeObjects ignora valores de entrada null. Se todos os valores de entrada forem null, $mergeObjects retornará um documento vazio { }.

$mergeObjects substitui os valores dos campo à medida que mescla documentos. Se vários documentos de entrada contiverem o mesmo nome de campo , a saída conterá o valor do último documento de entrada que contém o campo conflitante.

{ $mergeObjects: [ { a: 1 }, null ] }

{ a: 1 }

{ $mergeObjects: [ null, null ] }

{ }

{
   $mergeObjects: [
      { a: 1 },
      { a: 2, b: 2 },
      { a: 3, c: 3 }
   ]
}

{ a: 3, b: 2, c: 3 }

{
  $mergeObjects: [
    { a: 1 },
    { a: 2, b: 2 },
    { a: 3, b: null, c: 3 }
  ]
}

{ a: 3, b: null, c: 3 }

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.

O pipeline a seguir usa $mergeObjects em $replaceWith para mesclar os subdocumentos imdb e tomatoes.critic de cada filme em um único documentoratings. Ambos os subdocumentos contêm um camporating , portanto, $mergeObjects substitui a classificação imdb pela classificação tomatoes.critic. Campos exclusivos de cada subdocumento são preservados no resultado.

db.movies.aggregate( [
   {
      $match: {
         genres: "Action",
         year: 2010,
         "imdb.rating": { $exists: true },
         "tomatoes.critic.rating": { $exists: true }
      }
   },
   { $sort: { title: 1 } },
   { $limit: 5 },
   {
      $replaceWith: {
         title: "$title",
         year: "$year",
         ratings: { $mergeObjects: [ "$imdb", "$tomatoes.critic" ] }
      }
   }
] )

[
  {
    title: '13 Assassins',
    year: 2010,
    ratings: {
      rating: 8,
      votes: 47152,
      id: 1436045,
      numReviews: 118,
      meter: 96
    }
  },
  {
    title: '14 Blades',
    year: 2010,
    ratings: {
      rating: 4.1,
      votes: 5496,
      id: 1442571,
      numReviews: 11,
      meter: 64
    }
  },
  {
    title: 'Batman: Under the Red Hood',
    year: 2010,
    ratings: {
      rating: 7.3,
      votes: 29421,
      id: 1569923,
      numReviews: 7,
      meter: 100
    }
  },
  {
    title: 'Black Death',
    year: 2010,
    ratings: {
      rating: 6.2,
      votes: 32582,
      id: 1181791,
      numReviews: 59,
      meter: 68
    }
  },
  {
    title: 'Boy Wonder',
    year: 2010,
    ratings: {
      rating: 6.4,
      votes: 7128,
      id: 1456060,
      numReviews: 5,
      meter: 40
    }
  }
]

No pipeline anterior:

• $match filtra para filmes de ação de 2010 com imdb.rating e tomatoes.critic.rating existentes.

• $sort classifica documentos alfabeticamente por title.

• $limit restringe a saída para documentos 5 para melhorar a legibilidade.

• $replaceWith utiliza $mergeObjects para mesclar $imdb e $tomatoes.critic em um camporatings.

  • Como ambos os subdocumentos contêm um camporating , $mergeObjects usa o valor de tomatoes.critic (o último argumento).

  • Os campos exclusivos votes e id de imdb, e numReviews e meter de tomatoes.critic, estão todos preservados.