behavior
분석 노드에 저장된 행위 프로파일의 빌드 데이터를 조회합니다. 날짜 범위를 지정하여 특정 기간의 데이터를 조회할 수 있습니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 로그인 사용자 (프로파일 소유자 또는 공유 대상, 관리자) |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
behavior guid=STR [from=DATE] [to=DATE]
옵션
guid=STR- 행위 프로파일 GUID
from=DATE- 조회 시작 시각.
yyyyMMddHHmmss형식으로 지정합니다. 생략하면 전체 기간의 시작부터 조회합니다. to=DATE- 조회 종료 시각.
yyyyMMddHHmmss형식으로 지정합니다. 생략하면 전체 기간의 끝까지 조회합니다.
출력 필드
행위 프로파일 빌드 쿼리의 결과 필드가 그대로 출력됩니다. 출력 필드는 각 행위 프로파일의 빌드 쿼리에 따라 달라집니다.
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 300101 | 유효하지 않은 세션입니다. | 세션이 유효하지 않은 경우 |
| 300102 | from 옵션을 yyyyMMddHHmmss 형식으로 입력해주세요. | from 옵션 값이 올바른 날짜 형식이 아닌 경우 |
| 300103 | to 옵션을 yyyyMMddHHmmss 형식으로 입력해주세요. | to 옵션 값이 올바른 날짜 형식이 아닌 경우 |
| 300104 | 행위 프로파일을 찾을 수 없습니다. | 지정된 GUID에 해당하는 행위 프로파일이 없는 경우 |
| 300105 | 유효하지 않은 guid 옵션 포맷입니다. | guid 옵션 값이 유효한 GUID 형식이 아닌 경우 |
| 300106 | 데이터 접근 권한이 없습니다. | 해당 행위 프로파일에 대한 접근 권한이 없는 경우 |
| 300118 | behavior 명령어에 guid 옵션을 지정하세요. | guid 옵션을 지정하지 않은 경우 |
런타임 오류
해당 사항 없음
설명
behavior 명령어는 분석 노드에 저장된 행위 프로파일의 빌드 결과 데이터를 조회합니다. 행위 프로파일이 아직 빌드되지 않은 경우 결과가 출력되지 않습니다.
from과 to 옵션으로 날짜 범위를 지정하여 특정 기간의 데이터만 조회할 수 있습니다. 날짜 형식은 yyyyMMddHHmmss입니다.
이 명령어는 프로파일 소유자, 공유 대상 사용자, 또는 관리자만 실행할 수 있습니다. 다른 테넌트의 프로파일에 접근하려면 마스터 관리자 권한이 필요합니다.
사용 예
-
행위 프로파일 전체 데이터 조회
behavior guid=550e8400-e29b-41d4-a716-446655440000지정된 GUID의 행위 프로파일 빌드 데이터를 전체 기간에 걸쳐 조회합니다.
-
기간을 지정하여 데이터 조회
behavior guid=550e8400-e29b-41d4-a716-446655440000 from=20260101000000 to=202603172359592026년 1월 1일부터 2026년 3월 17일까지의 행위 프로파일 빌드 데이터를 조회합니다.
-
시작 시각만 지정하여 조회
behavior guid=550e8400-e29b-41d4-a716-446655440000 from=202603010000002026년 3월 1일 이후의 행위 프로파일 빌드 데이터를 조회합니다.
호환성
behavior 명령어는 4.0.2305.0 버전부터 사용 가능합니다.