first função para MATCH_RECOGNIZE

Aplica-se a: Databricks SQL Runtime 19.0 e superiores

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Devolve um valor de coluna relativo à primeira linha da correspondência. Use esta função apenas nas cláusulas MEASURES e DEFINE de MATCH_RECOGNIZE.

Para a função agregada genérica first , veja first.

Sintaxe

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

Argumentos

• colName: Uma coluna do table_reference que MATCH_RECOGNIZE opera em.
• rowPatternVar.colName: Uma coluna qualificada por um nome de variável padrão de linha. Lê o valor da coluna das linhas mapeadas para essa variável na correspondência atual. Por exemplo, FIRST(down.tstamp) devolve o carimbo temporal da primeira linha classificada como down.
• offset: Uma integral opcional literal maior ou igual a 0. O deslocamento em relação à primeira linha. A predefinição é 0.

Devoluções

Um valor do tipo colName. Se a linha identificada estiver fora da partição atual, devolve NULL.

Condições de erro comuns

• MATCH_RECOGNIZE_FUNCTION_OUTSIDE_MATCH_RECOGNIZE
• MATCH_RECOGNIZE_NAVIGATION_INVALID_INPUT

Funções relacionadas

• last função para MATCH_RECOGNIZE
• prev função para MATCH_RECOGNIZE
• next função para MATCH_RECOGNIZE
• MATCH_RECOGNIZE Funções