API/AI Gateway/Język naturalny do SQL

Język naturalny do SQL

POST/v1/ai/{project_id}/nl2sql

Konwertuje język naturalny na bezpieczne zapytania PostgreSQL tylko do odczytu sprawdzane przez analizator składni abstrakcyjnego drzewa składni (AST).

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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
  }
}

Wniosek

Parametry

Parametr	Typ	Wymagany	Opis
`question`	`string`	Tak	Pytanie w języku naturalnym dotyczące danych projektu.
`dialect`	`string`	NIE	Dialekt bazy danych. Akceptuje `'postgresql'` lub `'postgres'`.
`examples`	`object[]`	NIE	Opcjonalne, krótkie przykłady `[{ question, sql }]` prowadzące generowanie zapytań.
`limit`	`number`	NIE	Wstrzykiwany maksymalny limit wierszy, jeśli został pominięty przez model (domyślnie `100`, maks. `1000`).

Bezpieczeństwo

AST Strażnicy mutacji

Informacje

Serwer analizuje wygenerowany kod SQL za pomocą silnika abstrakcyjnego drzewa składni (AST) przed jego zwróceniem:

Każda instrukcja mutacji inna niż SELECT (INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE) jest natychmiast odrzucana za pomocą HTTP 400.
Tabele katalogów systemowych (pg_catalog, information_schema) są surowo zabronione.
Jeśli model pominie klauzulę LIMIT, serwer wstrzyknie LIMIT 100 (ograniczenie do 1000) i zaznaczy limit_injected: true.

v1.0 · poprawiony 31 paź 2026
↗ Specyfikacja OpenAPI↗ GitHuba

← POPRZEDNI

RAG query & ingest