left()

left() 함수는 문자열의 왼쪽부터 지정한 길이만큼 잘라서 반환합니다.

문법

left(STR, LENGTH)

매개변수

STR
잘라낼 대상 문자열입니다.
LENGTH
왼쪽부터 잘라낼 문자 수입니다. 0 이상의 값을 지정해야 합니다. 상수로 지정하는 경우 음수는 허용되지 않습니다.

설명

left() 함수는 STR의 왼쪽부터 LENGTH개의 문자를 잘라 반환합니다. STR의 길이가 LENGTH보다 짧으면 STR 전체를 반환합니다.

STR이 null이면 null을 반환합니다. STR이 문자열이 아닌 경우 toString()으로 변환하여 처리합니다.

LENGTH가 변수로 지정된 경우, 값이 null이거나 정수형이 아니면 null을 반환합니다. LENGTH가 음수이면 null을 반환합니다.

LENGTH가 상수로 지정된 경우 음수이면 오류 코드 90720을 발생시키며 쿼리 파싱에 실패합니다.

오류 코드

90720
LENGTH가 음수 상수로 지정된 경우 발생합니다.

사용 예

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

  1. URI 왼쪽 10자 잘라내기

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

  2. HTTP 프로토콜 버전에서 앞 4자 추출

    table limit=5 WEB_APACHE_SAMPLE | eval result = left(protocol, 4) | fields protocol, result
| # result: "HTTP"

  3. null 입력

    json "{'val': null}" | eval result = left(val, 4)
| # result: null

호환성

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