first Funktion für MATCH_RECOGNIZE

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 19.0 and above

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

Gibt einen Spaltenwert relativ zur ersten Zeile in der Übereinstimmung zurück. Verwenden Sie diese Funktion nur in den MEASURES - und DEFINE-Klauseln von MATCH_RECOGNIZE.

Die generische first Aggregatfunktion finden Sie unter first.

Syntax

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

Argumente

  • colName: Eine Spalte aus dem table_reference , die MATCH_RECOGNIZE ausgeführt wird.
  • rowPatternVar.colName: Eine Spalte, die durch den Namen einer Zeilenmustervariablen qualifiziert ist. Liest den Spaltenwert aus Zeilen, die dieser Variablen in der aktuellen Übereinstimmung zugeordnet sind. Gibt z. B. den Zeitstempel der ersten Zeile zurück, FIRST(down.tstamp) die als down.
  • offset: Ein optionales integrales Literal größer oder gleich 0. Der Offset relativ zur ersten Zeile. Der Standardwert lautet 0.

Returns

Ein Wert des Typs von colName. Wenn sich die identifizierte Zeile außerhalb der aktuellen Partition befindet, wird zurückgegeben NULL.

Häufige Fehlerbedingungen

  • Last updated on