ip()

값을 IP 주소 타입으로 변환합니다.

문법

ip(EXPR)

매개변수

EXPR
IP 주소로 변환할 값 또는 식.

설명

ip() 함수는 인수를 IP 주소 타입(InetAddress)으로 변환하여 반환합니다. 인수가 null이면 null을 반환합니다. 변환에 실패한 경우에도 null을 반환합니다.

지원하는 입력 타입별 동작은 다음과 같습니다.

  • 이미 IP 주소 타입: 그대로 반환합니다.
  • 숫자: 부호 있는 64비트 정수로 변환한 뒤 IPv4 점-십진 표기로 변환합니다. 값이 long 범위를 벗어나는 float이나 double이면 null을 반환합니다.
  • 문자열: / 뒤의 부분이 있으면 해당 부분만 파싱합니다 (CIDR 표기 지원). IPv4 및 IPv6 형식을 모두 지원합니다.
  • 배열 또는 리스트: 각 요소에 대해 재귀적으로 변환을 수행합니다.

IP 주소 타입은 문자열로 출력될 때 / 접두사가 붙습니다.

오류 코드

해당 사항 없음

사용 예

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

  1. 이미 IP 주소 타입인 src_ip 필드에 적용 (타입 보존)

    table limit=5 WEB_APACHE_SAMPLE | eval result = ip(src_ip) | fields src_ip, result
| # result: src_ip와 동일한 IP 주소

  2. IPv6 문자열을 IP 주소 타입으로 변환

    json "{'val': '2001:db8::1'}" | eval result = ip(val)
| # result: 2001:db8:0:0:0:0:0:1

  3. 숫자를 IP 주소 타입으로 변환

    json "{'val': 4294967295}" | eval result = ip(val)
| # result: 255.255.255.255

  4. NULL 입력

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

호환성

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