urldecode()

urldecode() 함수는 퍼센트 인코딩(percent-encoding)된 URL 문자열을 지정한 문자 집합으로 디코딩하여 반환합니다.

문법

매개변수

STR

디코딩할 URL 인코딩 문자열 필드 또는 값입니다.

CHARSET

(선택) 디코딩에 사용할 문자 집합입니다. 기본값은 "utf-8"입니다. IANA Charset Registry에 등록된 이름을 사용합니다.

설명

urldecode() 함수는 STR의 퍼센트 인코딩 시퀀스(예: %20)를 해당 문자로 변환한 문자열을 반환합니다. Java의 URLDecoder.decode() 메서드를 사용합니다.

• STR이 null이면 null을 반환합니다.
• 디코딩 중 오류가 발생하면 원본 STR 값을 그대로 반환합니다.
• CHARSET에 잘못된 문자 집합 이름을 지정하면 오류 코드 90850이 발생합니다.

오류 코드

사용 예

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

1. URI의 퍼센트 인코딩 디코딩

   table limit=5 WEB_APACHE_SAMPLE | eval result = urldecode(uri) | fields uri, result
   

2. EUC-KR 인코딩 URL 디코딩

   json "{'url': '%B7%CE%B1%D7%BA%D0%BC%AE'}" | eval result = urldecode(url, "EUC-KR")
   | # result: "로그분석"
   

3. 공백 디코딩

   json "{'val': 'hello%20world'}" | eval result = urldecode(val)
   | # result: "hello world"
   

4. NULL 입력

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

호환성

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