다음을 통해 공유

first_value 집계 함수

  • 아티클

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime

행 그룹에 대한 expr의 첫 번째 값을 반환합니다. 이 함수는 첫 번째 집계 함수와 동의어입니다.

구문

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

이 함수는 절을 사용하여 함수로 호출할 수도 있습니다.

인수

  • expr: 모든 형식의 식입니다.
  • ignoreNull: 기본값이 false인 선택적 리터럴 BOOLEAN 입니다.
  • cond: 집계에 사용되는 행을 필터링하는 선택적 부울 식입니다.
  • IGNORE NULLS 또는 RESPECT NULLS: IGNORE NULLS가 사용되거나 ignoreNull이 true인 경우 Null인 모든 expr 값은 무시됩니다. 기본값은 RESPECT NULLS입니다.

반품

결과는 expr과 동일한 형식입니다.

이 함수는 비결정적입니다.

예제

> 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);
 5

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