Číst v angličtině

Sdílet prostřednictvím

first agregační funkce

  • Článek

Platí pro:zaškrtávací políčko označeno ano Databricks SQL zaškrtávací políčko označeno ano Databricks Runtime

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

Syntaxe

first(expr[, ignoreNull]) [FILTER ( WHERE cond ) ]

Tuto funkci lze také vyvolat jako funkci okna pomocí klauzule OVER.

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 NULLS nebo RESPECT NULLS: Pokud je použito IGNORE NULLS nebo ignoreNull, true jakákoli hodnota expr, která je NULL, je ignorována. Výchozí hodnota je RESPECT NULLS.

Návraty

Výsledek má stejný typ jako expr.

Tato funkce není deterministická.

Příklady

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

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

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

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

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