Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 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\$1VALUE NTH\$1VALUE La fonction de fenêtrage NTH\$1VALUE 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 Syntaxe ``` NTH_VALUE (expr, offset) [ IGNORE NULLS | RESPECT NULLS ] OVER ( [ PARTITION BY window_partition ] [ ORDER BY window_ordering frame_clause ] ) ``` ## Arguments 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\$1partition* Définit la plage d’enregistrements de chaque groupe dans la clause OVER. ORDER BY *window\$1ordering* 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\$1clause* 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](c_Window_functions.md#r_Window_function_synopsis). La fonction de fenêtrage NTH\$1VALUE 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 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) ```