53 lines
1.5 KiB
Markdown
53 lines
1.5 KiB
Markdown
---
|
|
name: sql-report
|
|
label: SQL 리포트
|
|
description: DB 쿼리를 실행하고 결과를 차트화하여 HTML/Excel 보고서로 생성합니다.
|
|
icon: \uE968
|
|
allowed-tools:
|
|
- sql_tool
|
|
- chart_create
|
|
- excel_create
|
|
- html_create
|
|
- data_pivot
|
|
tabs: cowork
|
|
---
|
|
|
|
데이터베이스에서 쿼리를 실행하고 결과를 시각화된 보고서로 생성하세요.
|
|
|
|
## 워크플로우
|
|
|
|
1. **DB 확인**: sql_tool로 테이블 목록 및 스키마 확인
|
|
2. **쿼리 작성**: 사용자 요청에 맞는 SQL 쿼리 작성
|
|
3. **데이터 조회**: sql_tool로 쿼리 실행
|
|
4. **데이터 가공**: data_pivot으로 집계/피벗 (필요 시)
|
|
5. **시각화**: chart_create로 차트 생성
|
|
6. **보고서**: html_create 또는 excel_create로 최종 보고서 생성
|
|
|
|
## 쿼리 작성 원칙
|
|
- SELECT 쿼리만 실행 (데이터 변경 금지)
|
|
- 결과 행 수 제한: LIMIT 1000 (대량 데이터 방지)
|
|
- 인덱스 활용 쿼리 작성
|
|
- 한글 컬럼명은 alias로 변환
|
|
|
|
## 보고서 구성
|
|
|
|
### 1. 데이터 요약
|
|
- 조회 조건, 기간, 데이터 건수
|
|
- 기본 통계 (합계, 평균, 최대/최소)
|
|
|
|
### 2. 시각화
|
|
- 적절한 차트 유형 자동 선택
|
|
- 비교 → 바 차트
|
|
- 추세 → 라인 차트
|
|
- 비율 → 파이/도넛 차트
|
|
|
|
### 3. 상세 데이터
|
|
- Excel: 원본 데이터 + 서식 + 수식
|
|
- HTML: 테이블 + 정렬/필터
|
|
|
|
## 규칙
|
|
- DB 경로는 사용자에게 확인
|
|
- 민감 데이터(개인정보) 마스킹 권고
|
|
- 쿼리 실행 전 사용자 승인
|
|
- 한국어로 보고서 작성
|