자연어를 SQL로
POST
/v1/ai/{project_id}/nl2sql자연어를 추상 구문 트리(AST) 파서가 확인한 안전한 읽기 전용 PostgreSQL 쿼리로 변환합니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
#
요청
매개변수
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
question | string | 응 | 프로젝트 데이터에 대한 자연어 질문입니다. |
dialect | string | 아니 | 데이터베이스 방언. 'postgresql' 또는 'postgres'을 허용합니다. |
examples | object[] | 아니 | 쿼리 생성을 안내하는 선택적 몇 가지 예시 [{ question, sql }]. |
limit | number | 아니 | 모델에서 생략된 경우 최대 행 제한이 주입됩니다(기본값 100, 최대 1000). |
#
보안
AST 돌연변이 가드
정보
서버는 생성된 SQL을 반환하기 전에 추상 구문 트리(AST) 엔진으로 구문 분석합니다.
- SELECT가 아닌 변형 문(
INSERT,UPDATE,DELETE,DROP,ALTER,TRUNCATE)은HTTP 400를 사용하여 즉시 거부됩니다. - 시스템 카탈로그 테이블(
pg_catalog,information_schema)은 엄격히 허용되지 않습니다. - 모델이
LIMIT절을 생략하면 서버는LIMIT 100(최대 1000)을 삽입하고limit_injected: true를 표시합니다.
v1.0 · 개정 2026. 10. 31.