first 用于MATCH_RECOGNIZE的函数

适用于:勾选标记为是 Databricks SQL 勾选为 Databricks 运行时 19 及以上

Important

此功能在 Beta 版中。

返回与匹配中的第一行相对的列值。 仅在MATCH_RECOGNIZE的 MEASURES 和 DEFINE 子句中使用此函数。

有关泛型 first 聚合函数,请参阅 first。

Syntax

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

Arguments

  • colName:操作依据的table_referenceMATCH_RECOGNIZE列。
  • rowPatternVar.colName:由行模式变量名称限定的列。 从映射到当前匹配项中的变量的行中读取列值。 例如, FIRST(down.tstamp) 返回分类为 down第一行的时间戳。
  • offset:大于或等于 0的可选整型文本。 相对于第一行的偏移量。 默认值为 0。

Returns

某种类型的值 colName。 如果标识的行在当前分区之外,则 NULL返回 。

常见错误条件