自然语言到 SQL
POST
/v1/ai/{project_id}/nl2sql将自然语言转换为由抽象语法树 (AST) 解析器检查的安全、只读 PostgreSQL 查询。
该页面已自动翻译。英文版具有权威性。
#
请求
参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
question | string | 是的 | 有关项目数据的自然语言问题。 |
dialect | string | 不 | 数据库方言。接受 'postgresql' 或 'postgres'。 |
examples | object[] | 不 | 可选的少量示例 [{ question, sql }] 指导查询生成。 |
limit | number | 不 | 如果模型省略则注入最大行限制（默认 100，最大 1000）。 |
#
安全性
AST 突变守卫
信息
服务器在返回之前使用抽象语法树 (AST) 引擎解析生成的 SQL：
- 任何非 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日