Definición
Fusiona un arreglo de documentos en un solo documento.
Nota
Desambiguación
Esta página describe $mergeObjects cuando se utiliza como una expresión, que fusiona un arreglo de documentos.
También puede usar $mergeObjects en estos otros contextos:
$mergeObjects (accumulator), que devuelve un documento fusionado en un grupo de documentos de entrada.$mergeObjects (window function), que se utiliza en la$setWindowFieldsetapa para devolver un documento combinado de documentos en una ventana.
Sintaxis
Cuando se utiliza como expresión, $mergeObjects tiene esta sintaxis:
{ $mergeObjects: <expression> }El operando <expression> puede ser uno de los siguientes:
Una única expresión que se evalúa como un arreglo de documentos para fusionar. Por ejemplo,
$blogPostsdonde el campo del documentoblogPostscontiene un arreglo de documentos.Un arreglo de expresiones, cada una de las cuales se evalúa como un documento. Por ejemplo,
[ "$doc1", "$doc2", "$doc3" ]donde cada campo de documento contiene un único 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 | Resultados |
|---|---|
| |
| |
| |
| |
Ejemplo
Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.
El siguiente pipeline utiliza $mergeObjects en $replaceWith para fusionar los subdocumentos imdb y tomatoes.critic de cada película en un único documento ratings. Ambos subdocumentos contienen un campo rating, por lo que $mergeObjects sobrescribe la calificación imdb con la calificación tomatoes.critic. Los campos únicos de cada subdocumento se conservan en el 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" ] } } }] )En el pipeline anterior:
$matchfiltra a películas de acción de 2010 con unimdb.ratingytomatoes.critic.ratingexistentes.$sortordena los documentos alfabéticamente portitle.$limitrestringe la salida a 5 documentos para mejorar la legibilidad.$replaceWithutiliza$mergeObjectspara fusionar$imdby$tomatoes.criticen un camporatings.Dado que ambos subdocumentos contienen un campo
rating,$mergeObjectsutiliza el valor detomatoes.critic(el último argumento).Los campos únicos
votesyiddeimdb, ynumReviewsymeterdetomatoes.critic, se conservan todos.