ceil()

ceil() 함수는 숫자를 지정한 자릿수에서 올림한 값을 반환합니다.

문법

ceil(NUM_EXPR[, NUM_DIGITS])

매개변수

NUM_EXPR
올림할 숫자 표현식. 32비트 정수, 64비트 정수, 16비트 정수, 32비트 실수, 64비트 실수 타입을 지원합니다.
NUM_DIGITS
(선택) 올림할 소수점 자릿수. 양수이면 소수점 아래 해당 자리에서 올림합니다. 0이면 소수점 첫째 자리에서 올림합니다. 음수이면 소수점 위 자릿수로 처리합니다. 생략하면 0으로 처리합니다.

설명

ceil() 함수는 NUM_EXPR의 값을 NUM_DIGITS로 지정한 자릿수에서 올림합니다.

정수 타입(32비트 정수, 64비트 정수, 16비트 정수)이 입력된 경우, NUM_DIGITS가 0 이상이면 올림이 필요하지 않으므로 입력값을 그대로 반환합니다. NUM_DIGITS가 음수인 경우에는 해당 자리에서 올림을 적용하고 64비트 정수를 반환합니다.

실수 타입(32비트 실수, 64비트 실수)이 입력된 경우에는 항상 올림 계산을 적용합니다.

NUM_EXPR이 null이거나 숫자가 아닌 경우 null을 반환합니다. NUM_DIGITS가 지정되었으나 정수 타입(32비트 정수, 64비트 정수, 16비트 정수)이 아닌 경우 null을 반환합니다.

오류 코드

해당 사항 없음

사용 예

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

  1. 바이트 수를 킬로바이트 단위로 올림

    table limit=5 WEB_APACHE_SAMPLE | eval result = ceil(bytes / 1024.0)
| fields bytes, result

  2. 소수점 첫째 자리에서 올림

    table limit=5 WEB_APACHE_SAMPLE | eval result = ceil(bytes / 1024.0, 1)
| fields bytes, result

  3. 음수 자릿수로 백 단위 올림

    table limit=5 WEB_APACHE_SAMPLE | eval result = ceil(bytes, -2)
| fields bytes, result

  4. NULL 입력

    json "{'val': null}" | eval result = ceil(val)
| # result: null

호환성

ceil() 함수는 소나 4.0 이전 버전부터 제공되었습니다.