next fonction pour MATCH_RECOGNIZE

S’applique à : Databricks SQL Databricks Runtime 19.0 et versions ultérieures

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Retourne une valeur de colonne suivante par rapport à la ligne active dans la correspondance. La ligne peut ne pas faire partie de la correspondance elle-même. Il s’agit de la ligne suivante dans la partition dans ORDER BY l’ordre. Utilisez cette fonction uniquement dans les clauses MEASURES et DEFINE de MATCH_RECOGNIZE.

Syntax

next ( { colName | rowPatternVar.colName } [, offset ] )

Arguments

• colName: colonne de l’élément table_reference sur lequel MATCH_RECOGNIZE fonctionne.
• rowPatternVar.colName: colonne qualifiée par un nom de variable de modèle de ligne. Lit la valeur de colonne des lignes mappées à cette variable dans la correspondance actuelle.
• offset: littéral intégral facultatif supérieur ou égal à 0. Décalage relatif à la ligne actuelle. La valeur par défaut est 1.

Returns

Valeur du type de colName. Si la ligne identifiée se trouve en dehors de la partition actuelle, retourne NULL.

Conditions d’erreur courantes

• MATCH_RECOGNIZE_FUNCTION_OUTSIDE_MATCH_RECOGNIZE
• MATCH_RECOGNIZE_NAVIGATION_INVALID_INPUT

Fonctions associées

• first fonction pour MATCH_RECOGNIZE
• last fonction pour MATCH_RECOGNIZE
• prev fonction pour MATCH_RECOGNIZE
• fonctions MATCH_RECOGNIZE