Flex Query

자주 쓰는 쿼리 패턴

# 사용자 검색
flex-ax query "SELECT * FROM users WHERE name LIKE '%이름%'"

# 특정 사용자의 결재 문서
flex-ax query "SELECT i.document_number, t.name as template, i.status, i.drafted_at
FROM instances i
JOIN templates t ON i.template_id = t.id
JOIN users u ON i.drafter_id = u.id
WHERE u.name LIKE '%이름%'
ORDER BY i.drafted_at DESC"

# 근태/휴가 현황
flex-ax query "SELECT u.name, a.type, a.date_from, a.date_to, a.days, a.status
FROM attendance a
JOIN users u ON a.user_id = u.id
WHERE a.date_from >= '2026-01-01'
ORDER BY a.date_from"

# 결재 대기 문서 (특정 결재자)
flex-ax query "SELECT i.document_number, t.name as template, u.name as drafter
FROM approval_lines al
JOIN instances i ON al.instance_id = i.id
JOIN templates t ON i.template_id = t.id
JOIN users u ON i.drafter_id = u.id
WHERE al.approver_id = (SELECT id FROM users WHERE name LIKE '%이름%')
  AND al.status = 'PENDING'"

# 필드값 검색 (EAV 구조)
flex-ax query "SELECT * FROM field_values WHERE field_name = '출장유형' AND value_text LIKE '%국내출장%'"

Output Format

• 사용자에게 직접 보여줄 때: 테이블 형태로 정리
• 건수가 많으면 요약 + 상위 N건 표시
• 집계 요청이면 합계/평균/건수 등 통계 포함
• 외부 서비스(Drive/Sheets)로 내보낼 때: CSV 파일로 저장한 뒤 업로드

CSV 내보내기 예시

# JSON 결과를 CSV로 변환하여 저장
flex-ax query "SELECT u.name, i.document_number, t.name as template, fv.value_number as amount, fv.currency
FROM instances i
JOIN users u ON i.drafter_id = u.id
JOIN templates t ON i.template_id = t.id
LEFT JOIN field_values fv ON fv.instance_id = i.id AND fv.field_name LIKE '%금액%'
WHERE t.category = '비용 지급 요청'
ORDER BY i.drafted_at DESC" > /tmp/result.json

# JSON → CSV 변환 (python or jq)
python3 -c "
import json, csv, sys
data = json.load(sys.stdin)
if data:
    w = csv.DictWriter(sys.stdout, fieldnames=data[0].keys())
    w.writeheader()
    w.writerows(data)
" < /tmp/result.json > expense-report.csv

Stop Conditions

• 쿼리 실행 완료 및 결과 전달
• DB 파일이 없으면 flex-crawl 안내
• SQL 오류 시 스키마 확인 후 재시도 (최대 2회)