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.

$setWindowFields (etapa de agregación)

$setWindowFields

Nuevo en la versión 5.0.

Realiza operaciones en un intervalo especificado de documentos de una colección, conocido como ventana, y devuelve los resultados en función del operador de ventana elegido.

Por ejemplo, se puede utilizar la etapa $setWindowFields para dar salida a la:

  • Diferencia de ventas entre dos documentos de una colección.

  • Clasificaciones de ventas.

  • Totales de ventas acumuladas.

  • Análisis de información compleja de series de tiempo sin exportar los datos a una base de datos externa.

La sintaxis de la etapa $setWindowFields:

{ $setWindowFields: { partitionBy: <expression>, sortBy: { <sort field 1>: <sort order>, <sort field 2>: <sort order>, ..., <sort field n>: <sort order> }, output: { <output field 1>: { <window operator>: <window operator parameters>, window: { documents: [ <lower boundary>, <upper boundary> ], range: [ <lower boundary>, <upper boundary> ], unit: <time unit> } }, <output field 2>: { ... }, ... <output field n>: { ... } } }}

La etapa $setWindowFields toma un documento con estos campos:

Campo
Necesidad
Descripción

Opcional

Especifica una expresión para agrupar los documentos. En la etapa $setWindowFields, el grupo de documentos se conoce como partición. Por defecto es una partición para toda la colección.

Requerido para algunos operadores (se puede consultar Restricciones)

Especifica el campo o los campos por los que ordenar los documentos en la partición. Utiliza la misma sintaxis que la etapa $sort. El valor por defecto es no ordenar.

Requerido

Especifica el/los campo(s) que se agregarán a los documentos en la salida devuelta por la etapa $setWindowFields. Cada campo se establece en el resultado devuelto por el operador de ventana.

Un campo puede contener puntos para especificar campos de documentos incrustados y campos de arreglo. La semántica para la notación de puntos del documento incrustado en la etapa $setWindowFields es la misma que en las etapas $addFields y $set. Se puede consultar el ejemplo del documento incrustado $addFields y el ejemplo del documento incrustado $set.

Opcional

Especifica los límites y parámetros de la ventana. Los límites de la ventana son inclusivos. Por defecto, es un período ilimitado, que incluye todos los documentos de la partición.

Se debe especificar una ventana de documentos o de rango.

Opcional

Una ventana en la que los límites inferior y superior se especifican en relación con la posición del documento actual leído de la colección.

Los límites de la ventana se especifican mediante un arreglo de dos elementos que contiene un límite inferior y superior como string o número entero. Uso:

  • El string "current" para la posición actual del documento en la salida.

  • El string "unbounded" para la primera o la última posición del documento en la partición.

  • Un número entero para una posición relativa al documento actual. Utiliza un número entero negativo para una posición anterior al documento actual. Utiliza un número entero positivo para una posición después del documento actual. 0 es la posición actual del documento.

Consulte ejemplos de ventanas de documentos.

Opcional

Una ventana donde los límites inferior y superior se definen mediante un rango de valores basado en el campo sortBy del documento actual.

Los límites de la ventana se especifican mediante un arreglo de dos elementos que contiene un string o un número de límite inferior y superior. Uso:

  • El string "current" para la posición actual del documento en la salida.

  • El string "unbounded" para la primera o la última posición del documento en la partición.

  • Un número para agregar al valor del campo sortBy del documento actual. Un documento está en la ventana si el valor del campo sortBy está inclusive dentro de los límites inferior y superior.

Consulta Ejemplo de ventana de rango.

Opcional

Especifica las unidades para los límites de ventana de rango de tiempo. Puede establecerse en una de estas cadenas:

  • "year"

  • "quarter"

  • "month"

  • "week"

  • "day"

  • "hour"

  • "minute"

  • "second"

  • "millisecond"

Si se omite, se utilizan los límites de la ventana de rango numérico por defecto.

Se pueden consultar ejemplos de ventanas de rango de tiempo.

La etapa $setWindowFields agrega nuevos campos a los documentos existentes. Puedes incluir una o más etapas $setWindowFields en una operación de agregación.

A partir de MongoDB 5.3, puedes usar la etapa $setWindowFields con transacciones y el nivel de consistencia de lectura "snapshot".

La etapa $setWindowFields no garantiza el orden de los documentos devueltos.

Estos operadores se pueden utilizar con la etapa $setWindowFields:

Restricciones para la etapa $setWindowFields:

  • Antes de MongoDB 5.3, el $setWindowFields stage no puede utilizarse:

  • sortBy es necesario para lo siguiente:

  • Las ventanas de rango exigen que todos los valores de sortBy sean números.

  • Las ventanas de rango de tiempo requieren que todos los valores de sortBy sean fechas.

  • Las ventanas de rango y de rango de tiempo solo pueden contener un campo sortBy y la clasificación debe ser ascendente.

  • No se puede especificar una ventana de documentos y una ventana de rango a la vez.

  • Estos operadores utilizan una ventana implícita y devuelven un error si especificas una opción de ventana:

  • En las ventanas de rango, solo se incluyen en la ventana los números del rango especificado. Se excluyen los valores faltantes, indefinidos y null.

  • Para ventanas de rango de tiempo:

    • En la ventana solo se incluyen los tipos de fecha y hora.

    • Los valores de límite deben ser números enteros. Por ejemplo, puedes usar 2 horas como límite, pero no puedes usar 1,5 horas.

  • Para ventanas vacías o ventanas con valores incompatibles (por ejemplo, con $sum en strings), el valor devuelto depende del operador:

    • Para $count y $sum, el valor devuelto es 0.

    • Para $addToSet y $push, el valor devuelto es un arreglo vacío.

    • Para todos los demás operadores, el valor devuelto es null.

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.

En este ejemplo, se utiliza una ventana de documentos en $setWindowFields para obtener el valor acumulado de runtime para cada valor de rated. En el resultado del ejemplo, el campo cumulativeRuntimeForRating muestra el valor acumulado de runtime para cada calificación.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, rated: 1, released: 1, runtime: 1 } }, { $setWindowFields: { partitionBy: "$rated", sortBy: { released: 1 }, output: { cumulativeRuntimeForRating: { $sum: "$runtime", window: { documents: [ "unbounded", "current" ] } } } } }] )
[ { rated: 'G', title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), runtime: 81, cumulativeRuntimeForRating: 81 }, { rated: 'PG', title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), runtime: 115, cumulativeRuntimeForRating: 115 }, { rated: 'PG-13', title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), runtime: 130, cumulativeRuntimeForRating: 130 }, { rated: 'PG-13', title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), runtime: 103, cumulativeRuntimeForRating: 233 }, { runtime: 133, rated: 'PG-13', title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), cumulativeRuntimeForRating: 366 }, { rated: 'PG-13', title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 170, cumulativeRuntimeForRating: 536 }, { runtime: 195, rated: 'R', title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), cumulativeRuntimeForRating: 195 }, { runtime: 121, rated: 'R', title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), cumulativeRuntimeForRating: 316 }, { rated: 'R', title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 154, cumulativeRuntimeForRating: 470 }, { runtime: 119, title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), rated: 'R', cumulativeRuntimeForRating: 589 }, { rated: 'R', title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), runtime: 106, cumulativeRuntimeForRating: 695 }]

En el ejemplo:

  • partitionBy: "$rated" particiona los documentos de la colección en rated. Las particiones son G, PG, PG-13 y R.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1), de modo que la fecha released más antigua sea la primera.

  • output:

    • Establece el campo cumulativeRuntimeForRating en el valor acumulado de runtime para cada valor de rated; este valor aumenta mediante sumas sucesivas al valor anterior en la partición.

    • Calcula la runtime acumulativa con el operador $sum que se ejecuta en una ventana de documentos.

      La ventana contiene documentos entre un límite inferior de unbounded y el documento current. Esto significa que $sum devuelve la runtime acumulada para los documentos entre el inicio de la partición y el documento actual.

Este ejemplo utiliza una ventana de documentos en $setWindowFields para generar el runtime acumulado para cada $year en released. En la salida de ejemplo, el campo cumulativeRuntimeForYear muestra el runtime acumulado para cada año.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, released: 1, runtime: 1 } }, { $setWindowFields: { partitionBy: { $year: "$released" }, sortBy: { released: 1 }, output: { cumulativeRuntimeForYear: { $sum: "$runtime", window: { documents: [ "unbounded", "current" ] } } } } }] )
[ { title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), runtime: 130, cumulativeRuntimeForYear: 130 }, { title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), runtime: 103, cumulativeRuntimeForYear: 233 }, { runtime: 195, title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), cumulativeRuntimeForYear: 195 }, { runtime: 121, title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), cumulativeRuntimeForYear: 316 }, { runtime: 133, title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), cumulativeRuntimeForYear: 449 }, { title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 170, cumulativeRuntimeForYear: 619 }, { title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 154, cumulativeRuntimeForYear: 773 }, { title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), runtime: 115, cumulativeRuntimeForYear: 888 }, { runtime: 119, title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), cumulativeRuntimeForYear: 119 }, { title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), runtime: 106, cumulativeRuntimeForYear: 225 }, { title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), runtime: 81, cumulativeRuntimeForYear: 306 }]

En el ejemplo:

  • partitionBy: { $year: "$released" } particiona los documentos de la colección por $year en released. Hay particiones para 1993, 1994 y 1995.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1), de modo que la fecha released más antigua sea la primera.

  • output:

    • Establece el campo cumulativeRuntimeForYear en la runtime acumulada de cada año, que aumenta con las sucesivas incorporaciones al valor anterior de la partición.

    • Calcula la runtime acumulativa con el operador $sum que se ejecuta en una ventana de documentos.

      La ventana contiene documentos entre un límite inferior de unbounded y el documento current. Esto significa que $sum devuelve la runtime acumulada para los documentos entre el inicio de la partición y el documento actual.

En este ejemplo, se utiliza una ventana de documentos en $setWindowFields para obtener el promedio móvil runtime. En el resultado del ejemplo, el campo averageRuntime muestra el promedio móvil runtime.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, released: 1, runtime: 1 } }, { $setWindowFields: { partitionBy: { $year: "$released" }, sortBy: { released: 1 }, output: { averageRuntime: { $avg: "$runtime", window: { documents: [ -1, 0 ] } } } } }] )
[ { title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), runtime: 130, averageRuntime: 130 }, { title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), runtime: 103, averageRuntime: 116.5 }, { runtime: 195, title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), averageRuntime: 195 }, { runtime: 121, title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), averageRuntime: 158 }, { runtime: 133, title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), averageRuntime: 127 }, { title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 170, averageRuntime: 151.5 }, { title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 154, averageRuntime: 162 }, { title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), runtime: 115, averageRuntime: 134.5 }, { runtime: 119, title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), averageRuntime: 119 }, { title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), runtime: 106, averageRuntime: 112.5 }, { title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), runtime: 81, averageRuntime: 93.5 }]

En el ejemplo:

  • partitionBy: { $year: "$released" } particiona los documentos de la colección por $year en released. Hay particiones para 1993, 1994 y 1995.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1), de modo que la fecha released más antigua sea la primera.

  • output:

    • Establece el campo de averageRuntime al promedio móvil runtime de cada año.

    • Calcula el promedio móvil runtime utilizando el operador $avg que se ejecuta en una ventana de documentos.

      La ventana contiene documentos entre -1 y 0. Esto significa que $avg devuelve el promedia móvil runtime entre el documento anterior al documento actual (-1) y el documento actual (0) en la partición.

Este ejemplo utiliza una ventana de documentos en $setWindowFields para generar los valores acumulados y máximos de runtime para cada $year en released. En la salida de ejemplo, el campo cumulativeRuntimeForYear muestra el runtime acumulado y el campo maximumRuntimeForYear muestra el runtime máximo.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, released: 1, runtime: 1 } }, { $setWindowFields: { partitionBy: { $year: "$released" }, sortBy: { released: 1 }, output: { cumulativeRuntimeForYear: { $sum: "$runtime", window: { documents: [ "unbounded", "current" ] } }, maximumRuntimeForYear: { $max: "$runtime", window: { documents: [ "unbounded", "unbounded" ] } } } } }] )
[ { title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), runtime: 130, cumulativeRuntimeForYear: 130, maximumRuntimeForYear: 130 }, { title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), runtime: 103, cumulativeRuntimeForYear: 233, maximumRuntimeForYear: 130 }, { runtime: 195, title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), cumulativeRuntimeForYear: 195, maximumRuntimeForYear: 195 }, { runtime: 121, title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), cumulativeRuntimeForYear: 316, maximumRuntimeForYear: 195 }, { runtime: 133, title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), cumulativeRuntimeForYear: 449, maximumRuntimeForYear: 195 }, { title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 170, cumulativeRuntimeForYear: 619, maximumRuntimeForYear: 195 }, { title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 154, cumulativeRuntimeForYear: 773, maximumRuntimeForYear: 195 }, { title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), runtime: 115, cumulativeRuntimeForYear: 888, maximumRuntimeForYear: 195 }, { runtime: 119, title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), cumulativeRuntimeForYear: 119, maximumRuntimeForYear: 119 }, { title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), runtime: 106, cumulativeRuntimeForYear: 225, maximumRuntimeForYear: 119 }, { title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), runtime: 81, cumulativeRuntimeForYear: 306, maximumRuntimeForYear: 119 }]

En el ejemplo:

  • partitionBy: { $year: "$released" } particiona los documentos de la colección por $year en released. Hay particiones para 1993, 1994 y 1995.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1), de modo que la fecha released más antigua sea la primera.

  • output:

    • Establece el campo cumulativeRuntimeForYear en la runtime acumulada de cada año.

    • Calcula la runtime acumulativa con el operador $sum que se ejecuta en una ventana de documentos.

      La ventana contiene documentos entre un límite inferior de unbounded y el documento current. Esto significa que $sum devuelve la runtime acumulada para los documentos entre el inicio de la partición y el documento actual.

    • Establece el campo maximumRuntimeForYear en el máximo de runtime para cada año.

    • Calcula la runtime máxima de todos los documentos con el operador $max que se ejecuta en una ventana de documentos.

      La ventana contiene documentos entre un límite inferior de unbounded y upper. Esto significa que $max devuelve el valor máximo de runtime para los documentos de la partición.

Este ejemplo utiliza una ventana de rango en $setWindowFields para devolver la suma de los valores runtime de las películas estrenadas dentro de más o menos 10 minutos del valor runtime del documento actual. En el resultado del ejemplo, el campo runtimeFromSimilarMovies muestra la suma de los valores de runtime de los documentos en la ventana.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, rated: 1, runtime: 1 } }, { $setWindowFields: { partitionBy: "$rated", sortBy: { runtime: 1 }, output: { runtimeFromSimilarMovies: { $sum: "$runtime", window: { range: [ -10, 10 ] } } } } }] )
[ { rated: 'G', title: 'Toy Story', runtime: 81, runtimeFromSimilarMovies: 81 }, { rated: 'PG', title: 'Little Women', runtime: 115, runtimeFromSimilarMovies: 115 }, { rated: 'PG-13', title: 'King of the Hill', runtime: 103, runtimeFromSimilarMovies: 103 }, { rated: 'PG-13', title: 'The Fugitive', runtime: 130, runtimeFromSimilarMovies: 263 }, { runtime: 133, rated: 'PG-13', title: 'Quiz Show', runtimeFromSimilarMovies: 263 }, { rated: 'PG-13', title: 'Hoop Dreams', runtime: 170, runtimeFromSimilarMovies: 170 }, { rated: 'R', title: 'To Die For', runtime: 106, runtimeFromSimilarMovies: 106 }, { runtime: 119, title: 'Crumb', rated: 'R', runtimeFromSimilarMovies: 240 }, { runtime: 121, rated: 'R', title: 'The Piano', runtimeFromSimilarMovies: 240 }, { rated: 'R', title: 'Pulp Fiction', runtime: 154, runtimeFromSimilarMovies: 154 }, { runtime: 195, rated: 'R', title: "Schindler's List", runtimeFromSimilarMovies: 195 }]

En el ejemplo:

  • partitionBy: "$rated" particiona los documentos de la colección en rated. Las particiones son G, PG, PG-13 y R.

  • sortBy: { runtime: 1 } ordena los documentos de cada partición por runtime en orden ascendente (1), de modo que el runtime más corto sea el primero.

  • output establece el campo runtimeFromSimilarMovies en la suma de los valores runtime de los documentos de una ventana de rango.

    • La ventana contiene documentos entre un límite inferior de -10 y un límite superior de 10. El rango es inclusivo.

    • $sum devuelve la suma de los valores runtime incluidos en un rango de más o menos 10 minutos respecto al valor runtime del documento actual.

En el siguiente ejemplo, se utiliza una ventana con una unidad de rango de tiempo de límite superior positivo en $setWindowFields. El pipeline genera un arreglo de valores released para cada valor de rated que coincide con el rango de tiempo especificado. En la salida de ejemplo, el campo recentReleases muestra el arreglo de valores released.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, rated: 1, released: 1 } }, { $setWindowFields: { partitionBy: "$rated", sortBy: { released: 1 }, output: { recentReleases: { $push: "$released", window: { range: [ "unbounded", 10 ], unit: "month" } } } } }] )
[ { rated: 'G', title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), recentReleases: [ ISODate('1995-11-22T00:00:00.000Z') ] }, { rated: 'PG', title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), recentReleases: [ ISODate('1994-12-25T00:00:00.000Z') ] }, { rated: 'PG-13', title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), recentReleases: [ ISODate('1993-08-06T00:00:00.000Z'), ISODate('1993-08-20T00:00:00.000Z') ] }, { rated: 'PG-13', title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), recentReleases: [ ISODate('1993-08-06T00:00:00.000Z'), ISODate('1993-08-20T00:00:00.000Z') ] }, { rated: 'PG-13', title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), recentReleases: [ ISODate('1993-08-06T00:00:00.000Z'), ISODate('1993-08-20T00:00:00.000Z'), ISODate('1994-10-07T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z') ] }, { rated: 'PG-13', title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), recentReleases: [ ISODate('1993-08-06T00:00:00.000Z'), ISODate('1993-08-20T00:00:00.000Z'), ISODate('1994-10-07T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z') ] }, { rated: 'R', title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z') ] }, { rated: 'R', title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z') ] }, { rated: 'R', title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z'), ISODate('1995-04-28T00:00:00.000Z') ] }, { title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), rated: 'R', recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z'), ISODate('1995-04-28T00:00:00.000Z'), ISODate('1995-10-06T00:00:00.000Z') ] }, { rated: 'R', title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z'), ISODate('1995-04-28T00:00:00.000Z'), ISODate('1995-10-06T00:00:00.000Z') ] }]

En el ejemplo:

  • partitionBy: "$rated" particiona los documentos de la colección en rated. Las particiones son G, PG, PG-13 y R.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1), de modo que la fecha released más antigua sea la primera.

  • output:

    • Establece el campo recentReleases en un arreglo de valores de released para los documentos de cada partición de rated. Los elementos del arreglo se expanden con adiciones a los elementos anteriores en el arreglo.

    • Utiliza $push para devolver un arreglo de valores released de los documentos en una ventana de rango.

  • La ventana contiene documentos entre un límite inferior de unbounded y un límite superior establecido en 10 (10 meses después del valor released del documento actual) y utiliza una unidad de rango de tiempo.

  • $push devuelve el arreglo de valores released para los documentos entre el principio de la partición y los documentos con valores released inclusive en un rango del valor released del documento actual más 10 meses.

El siguiente ejemplo utiliza una ventana con una unidad de rango de tiempo de límite superior negativo en $setWindowFields. El pipeline genera un arreglo de valores released para cada valor de rated que coincide con el rango de tiempo especificado. En la salida de ejemplo, el campo recentReleases muestra el arreglo de valores released.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, rated: 1, released: 1 } }, { $setWindowFields: { partitionBy: "$rated", sortBy: { released: 1 }, output: { recentReleases: { $push: "$released", window: { range: [ "unbounded", -10 ], unit: "month" } } } } }] )
[ { rated: 'G', title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), recentReleases: [] }, { rated: 'PG', title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), recentReleases: [] }, { rated: 'PG-13', title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), recentReleases: [] }, { rated: 'PG-13', title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), recentReleases: [] }, { rated: 'PG-13', title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), recentReleases: [ ISODate('1993-08-06T00:00:00.000Z'), ISODate('1993-08-20T00:00:00.000Z') ] }, { rated: 'PG-13', title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), recentReleases: [ ISODate('1993-08-06T00:00:00.000Z'), ISODate('1993-08-20T00:00:00.000Z') ] }, { rated: 'R', title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), recentReleases: [] }, { rated: 'R', title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), recentReleases: [] }, { rated: 'R', title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), recentReleases: [] }, { title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), rated: 'R', recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z') ] }, { rated: 'R', title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), recentReleases: [ ISODate('1994-02-04T00:00:00.000Z'), ISODate('1994-02-11T00:00:00.000Z'), ISODate('1994-10-14T00:00:00.000Z') ] }]

En el ejemplo:

  • partitionBy: "$rated" particiona los documentos de la colección en rated. Las particiones son G, PG, PG-13 y R.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1), de modo que la fecha released más antigua sea la primera.

  • output:

    • Establece el campo recentReleases en un arreglo de valores de released para los documentos de cada partición de rated. Los elementos del arreglo se expanden con adiciones a los elementos anteriores en el arreglo.

    • Utiliza $push para devolver un arreglo de valores released de los documentos en una ventana de rango.

  • La ventana contiene documentos entre un límite inferior de unbounded y un límite superior establecido en -10 (10 meses antes del valor released del documento actual) con una unidad de rango de tiempo.

  • $push devuelve el arreglo de valores released para los documentos entre el principio de la partición y los documentos con valores released inclusive dentro de un rango del valor released del documento actual menos 10 meses.

El siguiente ejemplo utiliza $setWindowFields con el operador $shift y la etapa $set para comparar campos en una colección. En la salida de ejemplo, el campo runtimeComparison muestra el resultado de la comparación.

db.movies.aggregate( [ { $match: { metacritic: { $gt: 85 }, year: { $gte: 1993, $lte: 1995 } } }, { $project: { _id: 0, title: 1, rated: 1, released: 1, runtime: 1 } }, { $setWindowFields: { partitionBy: "$rated", sortBy: { released: 1 }, output: { previousRuntime: { $shift: { output: "$runtime", by: -1 } } } } }, { $set: { runtimeComparison: { $cond: [ { $eq: ["$runtime", "$previousRuntime"] }, "same", { $cond: [ { $gt: ["$runtime", "$previousRuntime"] }, "longer", "shorter" ] } ] } } },] )
[ { rated: 'G', title: 'Toy Story', released: ISODate('1995-11-22T00:00:00.000Z'), runtime: 81, previousRuntime: null, runtimeComparison: 'longer' }, { rated: 'PG', title: 'Little Women', released: ISODate('1994-12-25T00:00:00.000Z'), runtime: 115, previousRuntime: null, runtimeComparison: 'longer' }, { rated: 'PG-13', title: 'The Fugitive', released: ISODate('1993-08-06T00:00:00.000Z'), runtime: 130, previousRuntime: null, runtimeComparison: 'longer' }, { rated: 'PG-13', title: 'King of the Hill', released: ISODate('1993-08-20T00:00:00.000Z'), runtime: 103, previousRuntime: 130, runtimeComparison: 'shorter' }, { runtime: 133, rated: 'PG-13', title: 'Quiz Show', released: ISODate('1994-10-07T00:00:00.000Z'), previousRuntime: 103, runtimeComparison: 'longer' }, { rated: 'PG-13', title: 'Hoop Dreams', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 170, previousRuntime: 133, runtimeComparison: 'longer' }, { runtime: 195, rated: 'R', title: "Schindler's List", released: ISODate('1994-02-04T00:00:00.000Z'), previousRuntime: null, runtimeComparison: 'longer' }, { runtime: 121, rated: 'R', title: 'The Piano', released: ISODate('1994-02-11T00:00:00.000Z'), previousRuntime: 195, runtimeComparison: 'shorter' }, { rated: 'R', title: 'Pulp Fiction', released: ISODate('1994-10-14T00:00:00.000Z'), runtime: 154, previousRuntime: 121, runtimeComparison: 'longer' }, { runtime: 119, title: 'Crumb', released: ISODate('1995-04-28T00:00:00.000Z'), rated: 'R', previousRuntime: 154, runtimeComparison: 'shorter' }, { rated: 'R', title: 'To Die For', released: ISODate('1995-10-06T00:00:00.000Z'), runtime: 106, previousRuntime: 119, runtimeComparison: 'shorter' }]

En el ejemplo:

  • partitionBy: "$rated" particiona los documentos de la colección por rated para que los cálculos de cada puntuación se mantengan separados.

  • sortBy: { released: 1 } ordena los documentos de cada partición por released en orden ascendente (1).

  • output.previousRuntime utiliza el operador $shift para capturar el runtime de la película inmediatamente anterior dentro de la misma clasificación.

  • $set añade un nuevo campo denominado runtimeComparison y establece el valor de ese campo en longer, shorter o same en función de la comparación con previousRuntime.

Tip

Para ver otro ejemplo sobre el consumo energético IOT, consulta el libro electrónico Agregaciones prácticas de MongoDB.