Fonction de fenêtrage NTH_VALUE - Amazon Redshift

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Fonction de fenêtrage NTH_VALUE

La fonction de fenêtrage NTH_VALUE renvoie la valeur d’expression de la ligne spécifiée du cadre de fenêtrage associée à la première ligne de la fenêtre.

Syntaxe

NTH_VALUE (expr, offset) [ IGNORE NULLS | RESPECT NULLS ] OVER ( [ PARTITION BY window_partition ] [ ORDER BY window_ordering frame_clause ] )

Arguments

expr

Colonne cible ou expression sur laquelle la fonction opère.

offset

Détermine le nombre de lignes associé à la première ligne dans la fenêtre pour laquelle renvoyer l’expression. offset peut être une constante ou une expression et doit être un nombre entier positif qui est supérieur à 0.

IGNORE NULLS

Spécification facultative qui indique qu’Amazon Redshift doit ignorer les valeurs null pour déterminer les lignes à utiliser. Les valeurs NULL sont incluses si IGNORE NULLS n’est pas répertorié.

RESPECT NULLS

Indique qu’Amazon Redshift doit contenir des valeurs null pour déterminer la ligne à utiliser. La clause RESPECT NULLS est prise en charge par défaut, si vous ne spécifiez pas IGNORE NULLS.

OVER

Spécifie le partitionnement, l’ordonnancement et le cadre de fenêtrage.

PARTITION BY window_partition

Définit la plage d’enregistrements de chaque groupe dans la clause OVER.

ORDER BY window_ordering

Trie les lignes dans chaque partition. Si ORDER BY n’est pas spécifié, le cadre par défaut se compose de toutes les lignes de la partition.

frame_clause

Si une clause ORDER BY est utilisée pour une fonction d’agrégation, une clause de cadre explicite est requise. La clause de cadre affine l’ensemble de lignes dans la fenêtre d’une fonction, en incluant ou en excluant des ensembles de lignes du résultat ordonné. La clause de cadre se compose du mot-clé ROWS et des spécificateurs associés. Consultez Récapitulatif de la syntaxe de la fonction de fenêtrage.

La fonction de fenêtrage NTH_VALUE prend en charge les expressions qui utilisent l’un des types de données Amazon Redshift. Le type de retour est identique au type expr.

Exemples

L’exemple suivant présente le nombre de places dans le troisième plus grand site de Californie, de Floride et de New York, par rapport au nombre de places dans les autres sites de ces États :

select venuestate, venuename, venueseats, nth_value(venueseats, 3) ignore nulls over(partition by venuestate order by venueseats desc rows between unbounded preceding and unbounded following) as third_most_seats from (select * from venue where venueseats > 0 and venuestate in('CA', 'FL', 'NY')) order by venuestate; venuestate | venuename | venueseats | third_most_seats ------------+--------------------------------+------------+------------------ CA | Qualcomm Stadium | 70561 | 63026 CA | Monster Park | 69843 | 63026 CA | McAfee Coliseum | 63026 | 63026 CA | Dodger Stadium | 56000 | 63026 CA | Angel Stadium of Anaheim | 45050 | 63026 CA | PETCO Park | 42445 | 63026 CA | AT&T Park | 41503 | 63026 CA | Shoreline Amphitheatre | 22000 | 63026 FL | Dolphin Stadium | 74916 | 65647 FL | Jacksonville Municipal Stadium | 73800 | 65647 FL | Raymond James Stadium | 65647 | 65647 FL | Tropicana Field | 36048 | 65647 NY | Ralph Wilson Stadium | 73967 | 20000 NY | Yankee Stadium | 52325 | 20000 NY | Madison Square Garden | 20000 | 20000 (15 rows)