Definición
Devuelve un documento creado al combinar los documentos de entrada para cada grupo.
El acumulador $mergeObjects está disponible en estas etapas:
Nota
Desambiguación
Esta página describe $mergeObjects cuando se utiliza como acumulador. Los acumuladores devuelven un valor agregado en un grupo de documentos de entrada.
También puede usar $mergeObjects en estos otros contextos:
$mergeObjects (expression), que fusiona un arreglo de documentos en un único documento.$mergeObjects (window function), que se utiliza en la$setWindowFieldsetapa para devolver un documento combinado de documentos en una ventana.
Sintaxis
{ $mergeObjects: <expression> }El <expression> puede ser cualquier expresión válida que se evalúe en un documento.
Comportamiento
$mergeObjects ignora los valores de entrada de null. Si todos los valores de entrada son null, $mergeObjects devuelve un documento vacío { }.
$mergeObjects sobrescribe los valores de campo al combinar documentos. Si varios documentos de entrada contienen el mismo nombre de campo, la salida contiene el valor del último documento de entrada que contiene el campo en conflicto.
Ejemplo
Cree una colección movieReviews:
db.movieReviews.insertMany( [ { title: "Galactic Odyssey", source: "filmCritic", data: { rating: 8.1, votes: 1482903 } }, { title: "Galactic Odyssey", source: "viewerVault", data: { tomatometer: 79, audienceScore: 85 } }, { title: "Neon Horizon", source: "filmCritic", data: { rating: 7.4, votes: 983201 } }, { title: "Neon Horizon", source: "viewerVault", data: { tomatometer: 68, audienceScore: 74 } }, { title: "The Last Protocol", source: "filmCritic", data: { rating: 8.7, votes: 2104567 } }, { title: "The Last Protocol", source: "viewerVault", data: { tomatometer: 91, audienceScore: 88 } }] )Cada película tiene dos documentos:
Uno de filmCritic con los campos
ratingyvotes.Uno de viewerVault con
tomatometeryaudienceScorecampos.
Dado que los dos documentos de origen tienen nombres de campo diferentes, $mergeObjects puede combinarlos en un perfil completo que incluye los cuatro campos.
El siguiente pipeline utiliza $mergeObjects en una etapa $group para combinar los datos de revisión de cada fuente en un único documento para cada película:
db.movieReviews.aggregate( [ { $group: { _id: "$title", allRatings: { $mergeObjects: "$data" } } }, { $sort: { _id: 1 } }] )En el pipeline anterior:
$groupagrupa documentos portitley utiliza$mergeObjectspara fusionar losdatasubdocumentos de cada origen. Debido a que los documentos FilmCritic y ViewerVault contienen nombres de campo diferentes, el resultado combinado incluye todos los campos de ambas fuentes.$sortordena los resultados alfabéticamente por título.