mod()

정수 나눗셈의 나머지 값을 반환합니다.

문법

mod(NUM_EXPR, DIVISOR)

매개변수

NUM_EXPR
나눗셈의 피제수. 32비트 정수 또는 64비트 정수 타입이어야 합니다.
DIVISOR
나누는 수. 32비트 정수 또는 64비트 정수 타입이어야 합니다.

설명

mod() 함수는 NUM_EXPRDIVISOR로 나눈 나머지를 64비트 정수로 반환합니다.

다음 경우에 null을 반환합니다.

  • NUM_EXPR 또는 DIVISOR가 null인 경우
  • NUM_EXPR 또는 DIVISOR가 정수 타입(32비트 정수, 64비트 정수)이 아닌 경우
  • DIVISOR가 0인 경우 (0으로 나누기 방지)

오류 코드

오류 코드설명
invalid-mod-args인자 개수가 정확히 2개가 아닌 경우

사용 예

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

  1. HTTP 상태 코드에서 백의 자리를 제외한 나머지를 계산합니다.

    table limit=5 WEB_APACHE_SAMPLE | eval result = mod(status, 100)
    | fields status, result
    
  2. 0으로 나누면 null을 반환합니다.

    json "{}" | eval r = mod(5, 0)
    | # r: null
    
  3. NULL 입력

    json "{}" | eval r = mod(null, 3)
    | # r: null
    

호환성

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