contains()

contains() 함수는 대상 값이 특정 값을 포함하는지 여부를 반환합니다.

문법

contains(TARGET, NEEDLE)

매개변수

TARGET
검색 대상 값입니다. 문자열, 배열, 리스트를 지정할 수 있습니다.
NEEDLE
TARGET에 포함되어 있는지 확인할 값입니다.

설명

TARGET과 NEEDLE의 타입에 따라 다음과 같이 동작합니다.

  • 문자열: TARGET 문자열에 NEEDLE 문자열이 부분 문자열로 포함되어 있으면 true, 그렇지 않으면 false를 반환합니다. 문자열이 아닌 값은 toString()으로 변환한 뒤 검사합니다.
  • 배열 또는 리스트: TARGET 배열이나 리스트의 요소 중 NEEDLE과 동일한 값이 있으면 true, 그렇지 않으면 false를 반환합니다.

TARGET 또는 NEEDLE이 null이면 false를 반환합니다.

오류 코드

해당 사항 없음

사용 예

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

  1. User-Agent에 크롤러 문자열 포함 여부 확인

    table limit=5 WEB_APACHE_SAMPLE | eval result = contains(agent, "Googlebot") | fields agent, result

  2. URI에 특정 경로 포함 여부 확인

    table limit=5 WEB_APACHE_SAMPLE | eval result = contains(uri, "/archives/") | fields uri, result

  3. null 입력

    json "{'val': null}" | eval result = contains(val, "foo")
| # result: false

호환성

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