sonar-export-report
보고서 서식을 기반으로 보고서 파일을 생성하여 지정한 경로에 저장합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 |
| 라이선스 사용량 | 집계 안 함 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
sonar-export-report template=STR format={docx|html|pdf|hwpx} from=STR to=STR path=STR
옵션
template=STR- 보고서 서식의 GUID
format={docx|html|pdf|hwpx}- 보고서 파일 형식
docx: Microsoft Word 문서html: HTML 문서pdf: PDF 문서hwpx: 한글 문서
from=STR- 보고서 데이터 범위의 시작 시각.
yyyyMMddHHmmss형식으로 지정합니다. 뒷자리를 생략하면 0으로 채워집니다. to=STR- 보고서 데이터 범위의 끝 시각.
yyyyMMddHHmmss형식으로 지정합니다. 뒷자리를 생략하면 0으로 채워집니다. path=STR- 보고서 파일을 저장할 경로
출력 필드
| 필드 | 타입 | 설명 |
|---|---|---|
file_path | 문자열 | 생성된 보고서 파일 경로 |
file_name | 문자열 | 생성된 보고서 파일 이름 |
file_size | 64비트 정수 | 생성된 보고서 파일 크기 (바이트) |
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 300101 | 유효하지 않은 세션입니다. | 세션이 유효하지 않거나 사용자를 찾을 수 없는 경우 |
| 300111 | template 옵션을 지정하세요. | template 옵션이 누락된 경우 |
| 300112 | template 옵션 값은 GUID 형식이어야 합니다. | template 옵션 값이 GUID 형식이 아닌 경우 |
| 300113 | 지정된 보고서 서식을 찾을 수 없습니다. | 지정한 GUID에 해당하는 보고서 서식이 존재하지 않는 경우 |
| 300114 | from 옵션 값을 yyyyMMddHHmmss 형식으로 지정하세요. | from 옵션이 누락되었거나 형식이 잘못된 경우 |
| 300115 | to 옵션 값을 yyyyMMddHHmmss 형식으로 지정하세요. | to 옵션이 누락되었거나 형식이 잘못된 경우 |
| 300116 | 보고서 파일을 출력할 경로를 path 옵션으로 지정하세요. | path 옵션이 누락된 경우 |
| 300117 | 보고서 파일 형식을 format 옵션으로 지정하세요. | format 옵션이 누락된 경우 |
런타임 오류
| 오류 코드 | 메시지 | 설명 | 후처리 동작 |
|---|---|---|---|
| - | report build task is cancelled | 보고서 생성 작업이 취소된 경우 | 쿼리를 중단합니다. |
| - | cannot find report | 보고서 생성 후 결과를 찾을 수 없는 경우 | 쿼리를 중단합니다. |
| - | cannot write report | 보고서 파일 저장 중 I/O 오류가 발생한 경우 | 쿼리를 중단합니다. |
설명
sonar-export-report 명령어는 지정된 보고서 서식과 시간 범위를 기반으로 보고서를 생성하고, 결과를 지정한 파일 경로에 저장합니다. 보고서 생성은 비동기로 처리되며, 생성이 완료될 때까지 대기한 후 렌더링을 수행합니다.
출력 경로의 상위 디렉터리가 존재하지 않으면 자동으로 생성합니다.
이 명령어는 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요하며, 접근 가능한 파일 경로가 제한됩니다. 자세한 내용은 파일 접근 제한을 참고하세요.
사용 예
각 사용 예의 파일 경로는 ALLOWED_FILE_SCAN_PATHS 설정에 포함되어 있다고 가정합니다.
-
PDF 보고서 생성
sonar-export-report template=550e8400-e29b-41d4-a716-446655440000 format=pdf from=20260301 to=20260401 path=/opt/logpresso/reports/monthly.pdf지정한 서식으로 2026년 3월 한 달 간의 PDF 보고서를 생성합니다.
-
DOCX 보고서 생성
sonar-export-report template=550e8400-e29b-41d4-a716-446655440000 format=docx from=20260317000000 to=20260317235959 path=/opt/logpresso/reports/daily.docx지정한 서식으로 2026년 3월 17일 하루 동안의 Word 보고서를 생성합니다.
호환성
sonar-export-report 명령어는 소나 4.0 이전 버전부터 제공되었습니다. 4.0.2511.0 버전부터 클러스터 관리자 권한이 필요합니다.