Definición
Devuelve un documento creado al combinar los documentos de entrada de una ventana.
Nota
Desambiguación
Esta página describe $mergeObjects cuando se utiliza como función de ventana.
También puede usar $mergeObjects en estos otros contextos:
$mergeObjects (accumulator), que devuelve un documento fusionado en un grupo de documentos de entrada.$mergeObjects (expression), que fusiona un arreglo de documentos en un único documento.
Sintaxis
{ $setWindowFields: { output: { <outputField>: { $mergeObjects: <document>, window: { <documents|range>: [ "unbounded", <upper> ] } } } }}Nota
La opción sortBy en $setWindowFields es opcional cuando el límite superior de la ventana es "unbounded" o cuando se omite window. sortBy es obligatorio cuando el límite superior de la ventana no es "unbounded", como "current".
Cuando omite sortBy, no se garantiza el orden en que $mergeObjects resuelve los nombres de campo en conflicto.
Campos de comandos
Campo | Tipo | Necesidad | Descripción |
|---|---|---|---|
| expresión | Requerido | Un nombre de campo o una expresión que se evalúa como un documento. |
| Documento | Opcional | Especifica la ventana de documentos sobre la que opera |
Comportamiento
No extraíbles Windows
$mergeObjects solo admite ventanas fijas, lo que significa que el límite inferior es "unbounded". Si especifica una ventana donde el límite inferior no es "unbounded", la operación devuelve un error.
Manejo de entrada nula
$mergeObjects ignora los valores de entrada de null. Si todos los valores de entrada son null, $mergeObjects devuelve un documento vacío { }.
Comportamiento de sobrescritura del campo
$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 productUpdates:
db.productUpdates.insertMany( [ { _id: 1, product: "gadget", date: ISODate("2024-01-01"), specs: { color: "blue" } }, { _id: 2, product: "gadget", date: ISODate("2024-01-02"), specs: { size: "medium" } }, { _id: 3, product: "gadget", date: ISODate("2024-01-03"), specs: { weight: 0.5 } }, { _id: 4, product: "widget", date: ISODate("2024-01-01"), specs: { color: "red" } }, { _id: 5, product: "widget", date: ISODate("2024-01-02"), specs: { material: "plastic" } }] )Cada documento representa un actualizar de producto que añade nuevos campos de especificación. Dado que cada actualización aporta diferentes nombres de campo al subdocumento specs, $mergeObjects puede acumular un perfil de especificación completo a medida que la ventana se expande.
El siguiente pipeline utiliza $mergeObjects en $setWindowFields para devolver una lista de especificaciones de productos que se actualiza acumulativamente a medida que se añaden nuevas especificaciones a la ventana. Para cada documento, cumulativeSpecs contiene las especificaciones fusionadas de todos los actualizar hasta el documento actual inclusive:
db.productUpdates.aggregate( [ { $setWindowFields: { partitionBy: "$product", sortBy: { date: 1 }, output: { cumulativeSpecs: { $mergeObjects: "$specs", window: { documents: [ "unbounded", "current" ] } } } } }, { $sort: { product: 1, date: 1 } }, { $project: { _id: 0, product: 1, date: 1, specs: 1, cumulativeSpecs: 1 } }] )En el pipeline anterior:
$setWindowFieldsdivide los documentos porproducty los ordena pordateen orden ascendente.$mergeObjectsutiliza una ventana deunboundedacurrentpara fusionar todos los documentosspecsdesde el principio de cada partición hasta el documento actual, produciendo una especificación acumulada continua.$sortordena los resultados finales porproductydateen orden ascendente.