first_value agregační funkce

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime

Vrátí první hodnotu expr pro skupinu řádků. Tato funkce je synonymem profirst agregační funkci.

Syntaxe

first_value(expr[, ignoreNull]) [FILTER ( WHERE cond ) ] [ IGNORE NULLS | RESPECT NULLS ]

Tuto funkci můžete také vyvolat jako funkci okna pomocí OVER klauzule.

Argumenty

  • expr: Výraz libovolného typu.
  • ignoreNull: Volitelný BOOLEAN literál, který má výchozí hodnotu false.
  • cond: Volitelný logický výraz filtrující řádky použité pro agregaci.
  • IGNORE NULLSnebo RESPECT NULLS: Pokud použijete IGNORE NULLS nebo nastavíte trueignoreNull hodnotu , funkce ignoruje všechny expr hodnoty, které mají hodnotu NULL. Výchozí hodnota je RESPECT NULLS.

Návraty

Výsledek má stejný typ jako expr.

Tato funkce není deterministická.

Příklady

> SELECT first_value(col) FROM VALUES (10), (5), (20) AS tab(col);
 10

> SELECT first_value(col) FROM VALUES (NULL), (5), (20) AS tab(col);
 NULL

> SELECT first_value(col, true) FROM VALUES (NULL), (5), (20) AS tab(col);
 5

> SELECT first_value(col) IGNORE NULLS FROM VALUES (10), (5), (NULL) AS tab(col);
 10

> SELECT first_value(col) FILTER (WHERE col > 5) FROM VALUES (5), (20) AS tab(col);
 20