Schema Sync

Trino 카탈로그의 스키마 메타데이터를 AI 인덱스에 동기화하는 API입니다. Text-to-SQL 정확도 향상을 위해 스키마 정보를 벡터화합니다.

엔드포인트

POST /api/v1/ai/schema/sync

설명: Trino 카탈로그의 스키마 메타데이터를 AI 인덱스로 동기화합니다.

요청 본문:

필드	타입	필수	설명
catalog	string	N	동기화할 카탈로그 (미지정 시 전체)

응답:

{
  "synced_tables": 42,
  "synced_columns": 350,
  "duration_ms": 1200
}

인증

JWT Bearer 토큰이 필요합니다.

참고

• 동기화 후 Ask/Ask+Execute API의 SQL 생성 정확도가 향상됩니다.
• 스키마 변경 시 재동기화가 필요합니다.
• 대규모 카탈로그의 경우 시간이 소요될 수 있습니다.

에러 코드

코드	설명
400	잘못된 카탈로그 이름
500	Trino 메타데이터 조회 또는 인덱싱 실패