Query

Trino SQL 쿼리 실행 및 결과 조회를 위한 API입니다. 쿼리 실행, 결과 페치, 취소, 이력 조회 기능을 제공합니다.

엔드포인트

POST /api/v1/query/execute

설명: SQL 쿼리를 비동기로 실행합니다.

요청 본문:

필드	타입	필수	설명
sql	string	Y	실행할 SQL 문
catalog	string	N	기본 카탈로그
schema	string	N	기본 스키마

응답:

{
  "query_id": "uuid",
  "status": "running"
}

GET /api/v1/query/{query_id}/results

설명: 실행된 쿼리의 결과를 조회합니다.

경로 파라미터:

파라미터	타입	설명
query_id	string	쿼리 ID

DELETE /api/v1/query/{query_id}

설명: 실행 중인 쿼리를 취소합니다.

GET /api/v1/query/history

설명: 쿼리 실행 이력을 조회합니다. 페이지네이션을 지원합니다.

인증

JWT Bearer 토큰이 필요합니다.

에러 코드

코드	설명
400	SQL 구문 오류 또는 잘못된 요청
404	쿼리 ID를 찾을 수 없음
500	Trino 서버 내부 오류