lead funzione finestra analitica

  • Articolo

Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime

Restituisce il valore di expr da una riga successiva all'interno della partizione. Questa funzione è un sinonimo di lag(expr, -offset, default).

Sintassi

lead(expr [, offset [, default] ] ) [ IGNORE NULLS | RESPECT NULLS ] OVER clause

Argomenti

  • expr: espressione di qualsiasi tipo.
  • offset: valore letterale INTEGER facoltativo che specifica l'offset.
  • default: espressione dello stesso tipo di expr.
  • IGNORE NULLS o RESPECT NULLS: quando IGNORE NULLS viene specificato, qualsiasi expr valore NULL viene ignorato. Il valore predefinito è RESPECT NULLS.
  • Clausola OVER: clausola che descrive la finestra. Vedere: Funzioni finestra.

Valori restituiti

Il tipo di risultato corrisponde a expr.

Se offset è positivo, il valore proviene dalla riga che segue la riga corrente specificata da offset ORDER BY nella clausola OVER. Un offset pari a 0 utilizza il valore della riga corrente. Un offset negativo utilizza il valore di una riga che precede la riga corrente. Se non si specifica offset il valore predefinito 1, la riga immediatamente seguente.

Se non è presente alcuna riga in corrispondenza dell'offset specificato all'interno della partizione utilizzata dall'oggetto specificato default . Il default valore predefinito è NULL. È necessario specificare una clausola ORDER BY.

Esempi

> SELECT a, b, lead(b) OVER (PARTITION BY a ORDER BY b)
    FROM VALUES ('A1', 2), ('A1', 1), ('A2', 3), ('A1', 1) tab(a, b);
 A1 1   1
 A1 1   2
 A1 2   NULL
 A2 3   NULL