dataset

데이터셋으로 정의된 쿼리를 소유자 권한으로 실행합니다. 데이터셋에 접근 권한이 있는 사용자는 데이터셋 소유자의 권한으로 쿼리를 실행할 수 있습니다.

명령어 속성

문법

옵션

guid=STR

실행할 데이터셋의 GUID

출력 필드

없음 (데이터 소스에 따라 동적으로 결정)

오류 코드

파싱 오류

런타임 오류

해당 사항 없음

설명

dataset 명령어는 데이터셋에 저장된 쿼리를 서브 쿼리로 실행합니다. 데이터셋 소유자의 세션을 생성하여 소유자의 권한으로 쿼리를 실행하므로, 데이터셋에 접근 권한이 있는 사용자는 본인에게 직접 권한이 없는 데이터에도 접근할 수 있습니다.

데이터셋의 소유자, 클러스터 관리자, 조직 관리자, 또는 데이터셋에 공유된 사용자만 실행할 수 있습니다. 그 외의 사용자가 실행하면 권한 오류가 발생합니다.

자기 자신을 호출하는 재귀 호출은 허용되지 않으며, 호출 스택에서 동일한 데이터셋 GUID가 감지되면 파싱 오류가 발생합니다.

쿼리 실행이 완료되면 소유자 세션을 자동으로 종료합니다.

사용 예

1. 데이터셋 실행

   dataset guid="550e8400-e29b-41d4-a716-446655440000"
   

   지정한 GUID의 데이터셋에 정의된 쿼리를 소유자 권한으로 실행합니다.

2. 데이터셋 결과에 가공 쿼리 적용

   dataset guid="550e8400-e29b-41d4-a716-446655440000"
   | search src_ip == ip("192.0.2.1")
   | stats count by dst_port
   

   데이터셋 실행 결과에서 출발지 IP가 192.0.2.1인 레코드를 필터링하고, 목적지 포트별 건수를 집계합니다.

호환성

dataset 명령어는 4.0.2305.0 버전부터 사용 가능합니다.