FIRST_ función de VALUE ventana

Dado un conjunto ordenado de filas, FIRST _ VALUE devuelve el valor de la expresión especificada con respecto a la primera fila del marco de la ventana.

Para obtener información sobre cómo seleccionar la última fila del marco, consulte LAST_ función VALUE de ventana.

Sintaxis

FIRST_VALUE( expression )[ IGNORE NULLS | RESPECT NULLS ]
OVER (
[ PARTITION BY expr_list ]
[ ORDER BY order_list frame_clause ]
)

Argumentos

expresión

La columna o expresión de destino sobre la que opera la función.

IGNORE NULLS

Cuando esta opción se usa con FIRST _VALUE, la función devuelve el primer valor del marco que no lo es NULL (o NULL si todos los valores lo estánNULL).

RESPECT NULLS

Indica que se AWS Clean Rooms deben incluir valores nulos a la hora de determinar qué fila utilizar. RESPECTNULLSse admite de forma predeterminada si no se especifica IGNORENULLS.

OVER

Introduce las cláusulas de ventana para la función.

PARTITIONPOR expr_list

Define la ventana para la función en términos de una o más expresiones.

ORDERDE order_list

Ordena las filas dentro de cada partición. Si no se especifica ninguna cláusula PARTITION BY, ORDER BY ordena toda la tabla. Si especifica una cláusula ORDER BY, también debe especificar una cláusula frame_clause.

Los resultados de la VALUE función FIRST _ dependen del orden de los datos. En los siguientes casos, los resultados son no determinísticos:

• Cuando no se especifica ninguna cláusula ORDER BY y una partición contiene dos valores diferentes para una expresión

• Cuando la expresión se evalúa como valores diferentes que corresponden al mismo valor de la lista ORDER BY.

frame_clause

Si se utiliza una cláusula ORDER BY para una función agregada, se requiere una cláusula frame explícita. La cláusula de marco limita el conjunto de filas en una ventana de función e incluye o excluye conjuntos de filas en del resultado ordenado. La cláusula frame consta de la ROWS palabra clave y los especificadores asociados. Consulte Resumen de la sintaxis de la función de ventana.

Tipo de retorno

Estas funciones admiten expresiones que utilizan tipos de AWS Clean Rooms datos primitivos. El tipo de retorno es el mismo que el tipo de datos de la expression.

Ejemplos

El siguiente ejemplo devuelve la capacidad de asientos de cada lugar de la VENUE tabla, con los resultados ordenados por capacidad (de mayor a menor). La VALUE función FIRST _ se usa para seleccionar el nombre del lugar que corresponde a la primera fila del marco: en este caso, la fila con el mayor número de asientos. Los resultados se dividen por estado, por lo que cuando el VENUESTATE valor cambia, se selecciona un nuevo primer valor. El marco de ventana está ilimitado de modo que el primer valor se selecciona para cada fila en cada partición.

Para California, Qualcomm Stadium tiene la mayor cantidad de asientos (70561), por lo que nombre es el primer valor para todas las filas en la partición CA.

select venuestate, venueseats, venuename,
first_value(venuename)
over(partition by venuestate
order by venueseats desc
rows between unbounded preceding and unbounded following)
from (select * from venue where venueseats >0)
order by venuestate;

venuestate | venueseats |           venuename            |         first_value
-----------+------------+--------------------------------+------------------------------
CA         |      70561 | Qualcomm Stadium               | Qualcomm Stadium
CA         |      69843 | Monster Park                   | Qualcomm Stadium
CA         |      63026 | McAfee Coliseum                | Qualcomm Stadium
CA         |      56000 | Dodger Stadium                 | Qualcomm Stadium
CA         |      45050 | Angel Stadium of Anaheim       | Qualcomm Stadium
CA         |      42445 | PETCO Park                     | Qualcomm Stadium
CA         |      41503 | AT&T Park                      | Qualcomm Stadium
CA         |      22000 | Shoreline Amphitheatre         | Qualcomm Stadium
CO         |      76125 | INVESCO Field                  | INVESCO Field
CO         |      50445 | Coors Field                    | INVESCO Field
DC         |      41888 | Nationals Park                 | Nationals Park
FL         |      74916 | Dolphin Stadium                | Dolphin Stadium
FL         |      73800 | Jacksonville Municipal Stadium | Dolphin Stadium
FL         |      65647 | Raymond James Stadium          | Dolphin Stadium
FL         |      36048 | Tropicana Field                | Dolphin Stadium
...