Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

$mergeObjects (función de ventana)

$mergeObjects

Nuevo en la versión 8.3.

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:

{ $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.

Campo
Tipo
Necesidad
Descripción

<document>

expresión

Requerido

Un nombre de campo o una expresión que se evalúa como un documento. $percentile fusiona los valores del documento de todos los documentos de la ventana.

window

Documento

Opcional

Especifica la ventana de documentos sobre la que opera $percentile. El límite inferior debe ser "unbounded". Si se omite, la ventana incluye todos los documentos de la partición.

$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.

$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.

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:

  • $setWindowFields divide los documentos por product y los ordena por date en orden ascendente.

  • $mergeObjects utiliza una ventana de unbounded a current para fusionar todos los documentos specs desde el principio de cada partición hasta el documento actual, produciendo una especificación acumulada continua.

  • $sort ordena los resultados finales por product y date en orden ascendente.

Califique esta página

Documentación