Definición
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.
Sintaxis
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 | |
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 | |
Requerido | Especifica el/los campo(s) que se agregarán a los documentos en la salida devuelta por la etapa 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
| |
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:
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:
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:
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. |
Tip
Comportamiento
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.
Operadores de ventana
Estos operadores se pueden utilizar con la etapa $setWindowFields:
- Accumulator operators:
$addToSet,$avg,$bottom,$bottomN,$count,$covariancePop,$covarianceSamp,$derivative,$expMovingAvg,$firstN,$integral,$lastN,$max,$maxN,$median,$min,$minN,$percentile,$push,$stdDevSamp,$stdDevPop,$sum,$top,$topN.
- Operadores de relleno de vacíos:
$linearFilly$locf.
Restricciones
Restricciones para la etapa $setWindowFields:
Antes de MongoDB 5.3, el
$setWindowFieldsstage no puede utilizarse:en transacciones;
con
"snapshot"nivel de consistencia de lectura.
sortBy es necesario para lo siguiente:
Ventanas delimitadas (ya sea una ventana de documentos o una ventana de rango).
$linearFilloperador.
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.
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
$sumen strings), el valor devuelto depende del operador:Para todos los demás operadores, el valor devuelto es
null.
Ejemplos
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.
Ejemplos de ventanas de documentos
Usa la ventana de documentos para obtener el tiempo de ejecución acumulado para cada calificación
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 enrated. Las particiones sonG,PG,PG-13yR.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1), de modo que la fechareleasedmás antigua sea la primera.
output:Establece el campo
cumulativeRuntimeForRatingen el valor acumulado deruntimepara cada valor derated; este valor aumenta mediante sumas sucesivas al valor anterior en la partición.Calcula la
runtimeacumulativa con el operador$sumque se ejecuta en una ventana de documentos.La ventana contiene documentos entre un límite inferior de
unboundedy el documentocurrent. Esto significa que$sumdevuelve laruntimeacumulada para los documentos entre el inicio de la partición y el documento actual.
Usa la ventana de documentos para obtener el tiempo de ejecución acumulado de cada año.
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$yearenreleased. Hay particiones para1993,1994y1995.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1), de modo que la fechareleasedmás antigua sea la primera.output:Establece el campo
cumulativeRuntimeForYearen laruntimeacumulada de cada año, que aumenta con las sucesivas incorporaciones al valor anterior de la partición.Calcula la
runtimeacumulativa con el operador$sumque se ejecuta en una ventana de documentos.La ventana contiene documentos entre un límite inferior de
unboundedy el documentocurrent. Esto significa que$sumdevuelve laruntimeacumulada para los documentos entre el inicio de la partición y el documento actual.
Usa la ventana de documentos para obtener el promedio móvil del tiempo de ejecución de cada año
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$yearenreleased. Hay particiones para1993,1994y1995.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1), de modo que la fechareleasedmás antigua sea la primera.output:Establece el campo de
averageRuntimeal promedio móvilruntimede cada año.Calcula el promedio móvil
runtimeutilizando el operador$avgque se ejecuta en una ventana de documentos.La ventana contiene documentos entre
-1y0. Esto significa que$avgdevuelve el promedia móvilruntimeentre el documento anterior al documento actual (-1) y el documento actual (0) en la partición.
Usa la ventana de documentos para obtener el tiempo de ejecución acumulado y máximo de cada año
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$yearenreleased. Hay particiones para1993,1994y1995.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1), de modo que la fechareleasedmás antigua sea la primera.output:Establece el campo
cumulativeRuntimeForYearen laruntimeacumulada de cada año.Calcula la
runtimeacumulativa con el operador$sumque se ejecuta en una ventana de documentos.La ventana contiene documentos entre un límite inferior de
unboundedy el documentocurrent. Esto significa que$sumdevuelve laruntimeacumulada para los documentos entre el inicio de la partición y el documento actual.Establece el campo
maximumRuntimeForYearen el máximo deruntimepara cada año.Calcula la
runtimemáxima de todos los documentos con el operador$maxque se ejecuta en una ventana de documentos.La ventana contiene documentos entre un límite inferior de
unboundedyupper. Esto significa que$maxdevuelve el valor máximo deruntimepara los documentos de la partición.
Ejemplo de ventana de rango
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 enrated. Las particiones sonG,PG,PG-13yR.sortBy: { runtime: 1 }ordena los documentos de cada partición porruntimeen orden ascendente (1), de modo que elruntimemás corto sea el primero.outputestablece el camporuntimeFromSimilarMoviesen la suma de los valoresruntimede los documentos de una ventana de rango.
Ejemplos de ventanas de rango de tiempo
Utiliza una ventana de rango de tiempo con un límite superior positivo.
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 enrated. Las particiones sonG,PG,PG-13yR.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1), de modo que la fechareleasedmás antigua sea la primera.output:Establece el campo
recentReleasesen un arreglo de valores dereleasedpara los documentos de cada partición derated. Los elementos del arreglo se expanden con adiciones a los elementos anteriores en el arreglo.
$pushdevuelve el arreglo de valoresreleasedpara los documentos entre el principio de la partición y los documentos con valoresreleasedinclusive en un rango del valorreleaseddel documento actual más10meses.
Utiliza una ventana de rango temporal con un límite superior negativo.
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 enrated. Las particiones sonG,PG,PG-13yR.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1), de modo que la fechareleasedmás antigua sea la primera.output:Establece el campo
recentReleasesen un arreglo de valores dereleasedpara los documentos de cada partición derated. Los elementos del arreglo se expanden con adiciones a los elementos anteriores en el arreglo.
$pushdevuelve el arreglo de valoresreleasedpara los documentos entre el principio de la partición y los documentos con valoresreleasedinclusive dentro de un rango del valorreleaseddel documento actual menos10meses.
Ejemplo de comparación con valores anteriores
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 porratedpara que los cálculos de cada puntuación se mantengan separados.sortBy: { released: 1 }ordena los documentos de cada partición porreleaseden orden ascendente (1).output.previousRuntimeutiliza el operador$shiftpara capturar elruntimede la película inmediatamente anterior dentro de la misma clasificación.$setañade un nuevo campo denominadoruntimeComparisony establece el valor de ese campo enlonger,shorterosameen función de la comparación conpreviousRuntime.
La siguiente clase WeatherMeasurement representa documentos de una colección de mediciones meteorológicas:
[BsonIgnoreExtraElements]public class WeatherMeasurement{ [BsonId] public ObjectId Id { get; set; } [BsonElement("localityId")] public string LocalityId { get; set; } = null!; [BsonElement("measurementDateTime")] public DateTime MeasurementDateTime { get; set; } [BsonElement("rainfall")] public float Rainfall { get; set; } [BsonElement("temperature")] public float Temperature { get; set; }}Para utilizar el controlador de MongoDB .NET/C# para añadir una etapa $setWindowFields a una canalización de agregación, llame al método UnionWith() en un objeto PipelineDefinition.
En el siguiente ejemplo, se crea una etapa de pipeline que utiliza los campos Rainfall y Temperature para calcular la precipitación acumulada, la temperatura promedio móvil, la temperatura mediana y la precipitación del percentil 90 durante el último mes para cada localidad:
var pipeline = new EmptyPipelineDefinition<WeatherMeasurement>() .SetWindowFields( partitionBy: w => w.LocalityId, sortBy: Builders<WeatherMeasurement>.Sort.Ascending( w => w.MeasurementDateTime), output: o => new { MonthlyRainfall = o.Sum( w => w.Rainfall, RangeWindow.Create( RangeWindow.Months(-1), RangeWindow.Current) ), TemperatureAvg = o.Average( w => w.Temperature, RangeWindow.Create( RangeWindow.Months(-1), RangeWindow.Current) ), MedianTemperature = o.Median( w => w.Temperature, RangeWindow.Create( RangeWindow.Months(-1), RangeWindow.Current) ), NinetiethPercentileRainfall = o.Percentile( w => w.Rainfall, new[] { 0.9 }, RangeWindow.Create( RangeWindow.Months(-1), RangeWindow.Current) ) } );Los ejemplos de Node.js en esta página utilizan la colección sample_weatherdata.data de los conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, se puede consultar Primeros pasos en la documentación del driver de MongoDB Node.js.
Para utilizar el controlador de MongoDB Node.js para agregar una etapa de $setWindowFields a una canalización de agregación, utilice el Operador $setWindowFields en un objeto de canalización.
El siguiente ejemplo crea una etapa del pipeline que calcula el airTemperature.value promedio y el waveMeasurement.waves.height total para cada valor único de callLetters durante el último mes. A continuación, el ejemplo ejecuta el pipeline de agregación:
const pipeline = [ { $setWindowFields: { partitionBy: "$callLetters", sortBy: { ts: 1 }, output: { temperatureAvg: { $avg: "$airTemperature.value", window: { range: [-1, "current"], unit: "month" } }, totalWaveHeight: { $sum: "$waveMeasurement.waves.height", window: { range: [-1, "current"], unit: "month" } } } } },];
const cursor = collection.aggregate(pipeline);return cursor;Tip
Para ver otro ejemplo sobre el consumo energético IOT, consulta el libro electrónico Agregaciones prácticas de MongoDB.