Ask + Execute

자연어 질문을 SQL로 변환하고 즉시 실행하여 결과를 반환하는 API입니다. Ask와 Query Execute를 하나의 호출로 결합합니다.

엔드포인트

POST /api/v1/ai/ask/execute

설명: 자연어 질문을 SQL로 변환한 뒤, Trino에서 실행하여 결과를 반환합니다.

요청 본문:

필드	타입	필수	설명
question	string	Y	자연어 질문
catalog	string	N	대상 카탈로그
schema	string	N	대상 스키마

응답:

{
  "sql": "SELECT ...",
  "columns": ["col1", "col2"],
  "rows": [["val1", "val2"]],
  "explanation": "..."
}

인증

JWT Bearer 토큰이 필요합니다.

참고

• SQL 생성 후 SqlGuard를 통해 안전성이 검증됩니다.
• 위험한 SQL(DROP, DELETE 등)은 자동으로 차단될 수 있습니다.

에러 코드

코드	설명
400	질문이 비어있거나 잘못된 요청
403	SqlGuard에 의해 SQL 실행 차단
500	AI 변환 또는 Trino 실행 실패