first()

그룹 내에서 가장 먼저 나타난 null이 아닌 값을 반환합니다.

문법

매개변수

EXPR

첫 번째 값을 추출할 필드를 반환하는 표현식.

설명

first() 함수는 그룹 내 레코드를 순서대로 처리하면서 EXPR이 반환하는 값 중 null이 아닌 최초의 값을 기억합니다. 첫 번째 유효한 값이 기록된 이후에는 이후 레코드를 무시합니다. null 값은 건너뜁니다.

집계가 완료되면 기록된 첫 번째 값을 그대로 반환합니다. 반환 타입은 EXPR의 타입을 따릅니다. 그룹 내 유효한 값이 없으면 null을 반환합니다.

stats, timechart 등 집계 명령어에서만 사용할 수 있습니다.

오류 코드

사용 예

이 사용 예에서 조회하는 WEB_APACHE_SAMPLE 테이블을 준비하려면 쿼리 실습용 데이터를 참고하세요.

1. 각 출발지 IP의 첫 번째 요청 URI 추출

   table WEB_APACHE_SAMPLE | stats first(uri) by src_ip
   

2. HTTP 메서드별 첫 번째 요청의 응답 크기 추출

   table WEB_APACHE_SAMPLE | stats first(bytes) by method
   

3. null 값 처리

   json "[{'val': null}, {'val': null}, {'val': 30}]"
   | stats first(val)
   | # first(val): 30
   

호환성

first() 함수는 로그프레소 소나 4.0 이전부터 제공되었습니다.