max()

그룹 내 값들 중 최댓값을 반환합니다.

문법

max(EXPR)

매개변수

EXPR
최댓값을 구할 필드를 반환하는 표현식.

설명

max() 함수는 그룹 내 레코드를 처리하면서 EXPR이 반환하는 값 중 가장 큰 값을 추적합니다. null 값은 비교에서 제외됩니다.

정수형(integer, long), 실수형(float, double), 문자열, 날짜(timestamp) 등 다양한 타입을 비교할 수 있습니다. 서로 다른 숫자 타입 간에는 숫자 크기로 비교하며, 숫자가 아닌 타입은 ObjectComparator를 사용합니다. 서로 다른 비숫자 타입 간 비교는 정의되지 않은 동작을 수행할 수 있습니다.

집계가 완료되면 가장 큰 값을 반환합니다. 반환 타입은 입력 값의 타입을 따릅니다. 그룹 내 유효한 값이 없으면 null을 반환합니다.

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

오류 코드

코드설명
91020인자 수가 올바르지 않습니다.

사용 예

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

  1. 전체 요청 중 최대 응답 크기 계산

    table WEB_APACHE_SAMPLE | stats max(bytes)
    
  2. HTTP 상태 코드별 최대 응답 크기 계산

    table WEB_APACHE_SAMPLE | stats max(bytes) by status
    
  3. null 값 처리

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

호환성

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