sonar-datasets
로그프레소 소나에 등록된 모든 데이터셋 목록을 조회합니다. 각 데이터셋의 GUID, 이름, 종류, 소유자, 공유 대상 등 속성을 함께 반환합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 관리자 |
| 라이선스 사용량 | 집계함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
sonar-datasets
옵션
옵션 없음
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| guid | 문자열 | 데이터셋 GUID |
| name | 문자열 | 데이터셋 이름 |
| description | 문자열 | 데이터셋 설명 |
| type | 문자열 | 데이터셋 종류. query(쿼리 기반) 또는 pivot(피벗 기반) 중 하나입니다 |
| owner_guid | 문자열 | 데이터셋 소유자 GUID |
| owner_name | 문자열 | 데이터셋 소유자 이름 |
| app_code | 문자열 | 데이터셋이 속한 앱의 코드. 앱과 무관하게 직접 생성한 데이터셋은 null입니다 |
| shared_users | 배열 | 공유된 사용자 목록. 각 항목은 guid, name, type, read_only, created 필드를 가진 객체이며, created는 날짜 값이 아니라 yyyy-MM-dd HH:mm:ssZ 형식의 문자열입니다 |
| shared_groups | 배열 | 공유된 사용자 그룹 목록. 각 항목은 guid, name, type, read_only, created 필드를 가진 객체이며, created는 날짜 값이 아니라 yyyy-MM-dd HH:mm:ssZ 형식의 문자열입니다 |
| created | 날짜 | 생성일 |
| updated | 날짜 | 마지막 수정일 |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 300172 | 데이터셋 목록을 볼 권한이 없습니다 | 관리자 권한이 없는 계정으로 실행한 경우 |
런타임 오류
해당 사항 없음
설명
sonar-datasets 명령어는 필터 없이 등록된 모든 데이터셋을 조회 대상으로 삼습니다. 관리자 권한으로 실행하므로 소유자나 공유 여부와 관계없이 전체가 반환되며, 여러 회사(테넌트)가 등록된 설치에서는 다른 회사의 데이터셋도 함께 포함됩니다. 위젯이 참조하는 데이터셋과 dataset 명령어로 실행할 수 있는 데이터셋도 모두 포함되므로, 특정 데이터셋만 확인하려면 뒤에 search나 fields 명령어를 연결해 필터링해야 합니다.
조회한 데이터셋을 복제하려면 sonar-clone-datasets 명령어를 사용하세요.
사용 예
-
전체 데이터셋 목록 조회
sonar-datasets시스템에 등록된 모든 데이터셋의 속성을 반환합니다.
-
종류별 데이터셋 개수 집계
sonar-datasets | stats count by type데이터셋을
query,pivot종류별로 그룹화하여 개수를 집계합니다. -
특정 앱에 속한 데이터셋만 조회
sonar-datasets | search app_code == "threat-intel"app_code가threat-intel인 앱에서 생성한 데이터셋만 필터링합니다.
변경 이력
sonar-datasets 명령어는 소나 4.0.2609.0 버전부터 사용 가능합니다.
이 명령어는 실험실(Lab) 앱이 제공하던 것을 소나 코어에 내장한 것입니다(SNR#3463). 내장되지 않은 버전에서는 실험실 앱을 설치해 사용할 수 있습니다.