matchsig

필드의 문자열 값이 지정된 패턴 그룹에 포함되는지 확인하고, 매칭 결과에 따라 레코드를 필터링합니다.

명령어 속성

문법

옵션

guid=STR

매칭에 사용할 패턴 그룹의 GUID

field=STR

패턴 매칭 대상 문자열 필드 이름

invert=BOOL

t로 지정하면 패턴 그룹에 매칭되지 않는 레코드만 출력합니다. (기본값: f)

verify=BOOL

f로 지정하면 파싱 단계에서 패턴 그룹 유효성 검사를 생략합니다. (기본값: t)

입력 필드

출력 필드

입력 레코드의 필드를 그대로 전달합니다.

오류 코드

파싱 오류

런타임 오류

해당 사항 없음

설명

matchsig 명령어는 입력 레코드에서 지정된 필드의 문자열 값이 패턴 그룹에 정의된 패턴과 매칭되는지 확인합니다. 매칭되는 레코드만 출력하며, invert 옵션을 t로 지정하면 매칭되지 않는 레코드만 출력합니다.

필드 값이 null인 경우 매칭되지 않은 것으로 처리합니다. null이 아닌 값은 문자열로 변환하여 패턴 매칭을 수행합니다.

분산 환경에서는 수집 노드에서 필터링을 수행합니다.

사용 예

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

1. 웹 로그의 URI를 패턴 그룹으로 필터링

   table limit=1000 WEB_APACHE_SAMPLE
   | matchsig guid=550e8400-e29b-41d4-a716-446655440000 field=uri
   

   웹 서버 접근 로그의 URI 필드 값이 지정한 패턴 그룹에 매칭되는 레코드만 출력합니다.

2. 패턴 그룹에 매칭되지 않는 레코드 추출

   table limit=1000 WEB_APACHE_SAMPLE
   | matchsig guid=550e8400-e29b-41d4-a716-446655440000 field=uri invert=t
   

   URI 필드 값이 패턴 그룹에 매칭되지 않는 레코드만 출력합니다.

호환성

matchsig 명령어는 소나 4.0 이전 버전부터 제공되었습니다.