Window Función de script
Última actualización: 7/10/2026Window() realiza cálculos a partir de varias filas de una sección (o "ventana") de una tabla completa y genera un único valor para cada fila.
Puede utilizar las funciones Window para realizar operaciones como:
-
Comparar un valor numérico individual en una fila con el promedio, máximo o mínimo dentro de una ventana de la tabla.
-
Calcular la clasificación de un valor individual, ya sea dentro de la ventana o dentro de toda la tabla.
La función Window no modifica el número de registros de la tabla, pero puede realizar tareas similares a las funciones de agregación, relacionales y de rango.
La función Window debe incluirse dentro de la sentencia LOAD de la tabla con la que está trabajando, o hacer referencia a la tabla, como por ejemplo con un LOAD Resident. Por ejemplo, consulte Ejemplo: agregar un campo que contiene una agregación.
El nombre se puede omitir, pero esto hace que el nombre del campo se establezca en la totalidad de la expresión de la función Window. Por ejemplo, AvgDepSalary en el siguiente ejemplo:
Se recomienda asignar un nombre de campo a la función Window.
Window admite funciones generales, como el redondeo o las operaciones numéricas básicas. Por ejemplo:
La función Window examina toda la tabla. En términos de consumo de memoria, el coste de este escaneo es proporcional al número de campos de la tabla. Una tabla con pocos campos, además de aquellos sobre los que opera la función Window, siempre es preferible a una tabla con muchos campos.
Por lo general, una función Window consume de 2 a 4 veces más memoria y tarda de 2 a 4 veces más en tiempo de recarga en comparación con una operación de script similar que contenga la misma agregación, una cláusula Where (filtro), una cláusula Group by (partición) y una cláusula Order by (ordenación).
Tipo de datos devuelto: Un valor por fila, que se puede combinar con otra expresión o utilizar en ella, o agregarse directamente a la tabla resultante creada por la instrucción LOAD.
| Argumento | Descripción |
|---|---|
| main_expr |
La expresión de entrada principal que calcula y devuelve la función. Debe ser cualquier expresión basada en una agregación, por ej. Median(Salary). Por ejemplo: Window(Median(Salary)) as MedianSalary
La expresión también puede ser un nombre de campo sin que se aplique ninguna agregación. En este caso, Window lo trata como si la función Only() se aplicara a ese campo. Por ejemplo: Window(Salary) as WSalary
Las expresiones que incluyan agregaciones anidadas o funciones de ventana anidadas, como Window(Sum(Avg(Salary))) o Window(Sum(Window(Salary))), no están permitidas. |
| partition1, partition2 |
Después de main_expr, puede definir cualquier número de particiones. Las particiones son campos que definen con qué combinaciones aplicar las agregaciones. Por ejemplo: Window(Avg(Salary), Department) as AvgDepSalary
Esto calcula el salario medio para cada departamento. Cuando se proporcionan varios parámetros de partición, la agregación se aplicará a cada fila con una combinación única de campos de partición. Por ejemplo: Window(Avg(Salary), Department, Country) as AvgDepSalaryPerCountry
Esto calcula el salario medio para cada departamento en cada país. Los departamentos duplicados en diferentes países, como Marketing en Suecia y Marketing en Canadá, se tratarán como particiones diferentes. El particionamiento es similar a la agrupación que se obtiene mediante la cláusula group by. Sin embargo, la partición no reduce la cantidad de registros en comparación con la tabla de entrada. |
| sort_type, [sort_expr] |
Si lo desea, especifique el tipo de ordenación y la expresión de ordenación. Esto define el orden en el que se realiza la agregación. sort_type es una cadena constante y puede tener uno de tres valores:
Si define sort_type ASC o DESC, deberá definir una expresión de ordenación. Con sort_type NONE, no se debe proporcionar ninguna expresión de ordenación. La expresión de ordenación decide el orden de las filas dentro de una partición. Por ejemplo: Window(RecNo(), Department, 'ASC', Year)
En el ejemplo anterior, la agregación dentro de la partición se realiza de forma ascendente por el campo Año. Los parámetros de ordenación también afectan al orden en el que una ventana deslizante procesa una tabla. Para ver un ejemplo, consulte: Ejemplo - Adición de un campo con una ventana deslizante ordenada. |
| filter_expr |
Si lo desea, agregue una expresión de filtro. Esta es una expresión booleana que decide si el registro deberá incluirse en el cálculo o no. Si se proporciona filter_expr, se debe incluir un tipo de ordenación. Si no se define ningún tipo de ordenación, el argumento puede interpretarse como un parámetro de partición en lugar de como una expresión de filtro. El parámetro filter_expr se puede omitir por completo o se puede incluir un valor truthy. Ambos dan como resultado que no se utilice ningún filtro, por lo que no se excluye ninguna fila. Por ejemplo: Window(avg(Salary), Department, 'ASC', Age, Country='US' Or Country='Canada') as AvgDepSalaryInUsOrCanada
La instrucción Window anterior filtrará cualquier fila en la que el campo Country no sea US o Canada, excluyendo esas filas de la agregación. Seguirá habiendo valores de salida para las filas que se filtraron, pero, al igual que todas las demás filas de salida, solo contendrán resultados agregados de las filas que no estén excluidas por el filtro. |
| start_expr,end_expr |
Opcionalmente, establezca los argumentos para la funcionalidad de ventana deslizante. Esto limita aún más el número de filas que se agregarán conjuntamente. Cada fila de salida solo incluirá resultados (agregados) de un número de filas anteriores y posteriores a la fila actual. Una ventana deslizante requiere dos argumentos (start_expr,end_expr). Si se proporcionan estos argumentos, no se debe omitir el tipo de ordenación. De lo contrario, los argumentos podrían interpretarse como un parámetro de partición en lugar de una ventana deslizante. El parámetro start_expr,end_expr comprende:
Por ejemplo, si desea incluir las 3 filas anteriores, la fila actual y la siguiente fila: Window(concat(Text(Salary),'-'), Department, 'NONE', 1, -3, 1) as WSlidingSalaryDepartment
Para indicar todas las filas anteriores o todas las filas posteriores, puede utilizar la función Unbounded(). Por ejemplo, para incluir todas las filas anteriores, la fila actual y la fila siguiente: Window(concat(Text(Salary),'-'), Department, 'NONE', 1, UNBOUNDED(), 1) as WSlidingSalaryDepartment
Por ejemplo, para incluir la tercera fila de la fila actual y todas las filas posteriores: Window(concat(Text(Salary),'-'), Department, 'NONE', 1, 3, UNBOUNDED()) as WSlidingSalaryDepartment
En los ejemplos anteriores, se proporciona el tipo de ordenación NONE para que el script pueda distinguir entre los argumentos de partición y los parámetros que van después del tipo de ordenación. |
Ejemplo: agregar un campo que contiene una agregación
Ejemplo: agregar un campo que contiene una agregación con determinados valores filtrados
Ejemplo: agregar un campo con una ventana deslizante
Limitaciones
Window tiene las siguientes limitaciones:
-
Window es una función que consume muchos recursos, especialmente en términos de consumo de memoria.
-
Window no es compatible con Qlik Sense Mobile.
-
Las expresiones de gráfico no son compatibles con Window.
-
No puede anidar funciones Window dentro de otras funciones Window.
-
Window no se puede utilizar dentro de una función de agregación.
-
Window no se puede utilizar en una instrucción load con una cláusula group by.
-
Window no se puede utilizar en una instrucción LOAD con una cláusula WHERE
-
Window necesita poder escanear toda la tabla.
-
WRank(), RecNo() y RowNo() no se pueden usar con Window cuando se utiliza la función de ventana deslizante.
-
Cuando se utiliza la funcionalidad de ventana deslizante, el tiempo de cálculo aumenta con el tamaño de la ventana. Por lo general, se deben evitar las tablas grandes combinadas con tamaños de ventana grandes.
