first funktion för MATCH_RECOGNIZE

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 19.0 och senare

Important

Den här funktionen finns i Beta. Arbetsyteadministratörer kan styra åtkomsten till den här funktionen från sidan Förhandsversioner . Se Hantera förhandsversioner av Azure Databricks.

Returnerar ett kolumnvärde i förhållande till den första raden i matchningen. Använd endast den här funktionen i satserna MEASURES och DEFINEi MATCH_RECOGNIZE.

Den allmänna first mängdfunktionen finns i first.

Syntax

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

Arguments

  • colName: En kolumn från table_reference som MATCH_RECOGNIZE fungerar på.
  • rowPatternVar.colName: En kolumn som kvalificerats av ett variabelnamn för radmönster. Läser kolumnvärdet från rader som mappats till variabeln i den aktuella matchningen. Returnerar till exempel FIRST(down.tstamp) tidsstämpeln för den första raden som klassificeras som down.
  • offset: En valfri integralliteral som är större än eller lika med 0. Förskjutningen i förhållande till den första raden. Standardvärdet är 0.

Returns

Ett värde av typen colName. Om den identifierade raden ligger utanför den aktuella partitionen returnerar NULL.

Vanliga felvillkor