API/AI Gateway/Dal linguaggio naturale a SQL

Dal linguaggio naturale a SQL

POST/v1/ai/{project_id}/nl2sql

Converte il linguaggio naturale in query PostgreSQL sicure e di sola lettura controllate da un parser Abstract Syntax Tree (AST).

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

nl2sql.tstypescript

const { data, error } = await aura.ai.nl2sql(
  'What are the 10 most recent user registrations?',
  { dialect: 'postgresql', limit: 10 }
)
console.log('Safe SQL Query:', data?.sql)
console.log('Injected Limit:', data?.limit, 'Confidence:', data?.confidence)

200.jsonjson

{
  "data": {
    "sql": "SELECT id, email, created_at FROM users ORDER BY created_at DESC LIMIT 10;",
    "explanation": "Retrieves the latest 10 users ordered by creation timestamp.",
    "confidence": 0.96,
    "limit_injected": false,
    "limit": 10
  }
}

Richiesta

Parametri

Parametro	Digitare	Obbligatorio	Descrizione
`question`	`string`	sì	Domanda in linguaggio naturale sui dati del progetto.
`dialect`	`string`	no	Dialetto della banca dati. Accetta `'postgresql'` o `'postgres'`.
`examples`	`object[]`	no	Esempi facoltativi di pochi scatti `[{ question, sql }]` che guidano la generazione di query.
`limit`	`number`	no	Limite massimo di righe inserite se omesso dal modello (impostazione predefinita `100`, max `1000`).

Sicurezza

AST Protezioni mutazione

Informazioni

Il server analizza l'SQL generato con un motore Abstract Syntax Tree (AST) prima di restituirlo:

Qualsiasi istruzione di mutazione non SELECT (INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE) viene rifiutata immediatamente con HTTP 400.
Le tabelle del catalogo di sistema (pg_catalog, information_schema) sono severamente non consentite.
Se il modello omette una clausola LIMIT, il server inserisce LIMIT 100 (limitato a 1000) e contrassegna limit_injected: true.

v1.0 · rivisto 31 ott 2026
↗ Specifiche OpenAPI↗ GitHub

← PRECEDENTE

RAG query & ingest