एपीआई/AI Gateway/एसक्यूएल के लिए प्राकृतिक भाषा

एसक्यूएल के लिए प्राकृतिक भाषा

POST/v1/ai/{project_id}/nl2sql

प्राकृतिक भाषा को एब्सट्रैक्ट सिंटैक्स ट्री (AST) पार्सर द्वारा जांची गई सुरक्षित, केवल पढ़ने योग्य PostgreSQL क्वेरी में परिवर्तित करता है।

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

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

अनुरोध

पैरामीटर

पैरामीटर	प्रकार	आवश्यक	विवरण
`question`	`string`	हाँ	प्रोजेक्ट के डेटा के बारे में प्राकृतिक भाषा का प्रश्न।
`dialect`	`string`	नहीं	डेटाबेस बोली. `'postgresql'` या `'postgres'` स्वीकार करता है।
`examples`	`object[]`	नहीं	वैकल्पिक कुछ-शॉट उदाहरण `[{ question, sql }]` क्वेरी निर्माण का मार्गदर्शन करते हैं।
`limit`	`number`	नहीं	मॉडल द्वारा छोड़े जाने पर अधिकतम पंक्ति सीमा इंजेक्ट की जाती है (डिफ़ॉल्ट `100`, अधिकतम `1000`)।

सुरक्षा

AST म्यूटेशन गार्ड

जानकारी

सर्वर जेनरेट किए गए SQL को वापस करने से पहले उसे एब्सट्रैक्ट सिंटैक्स ट्री (AST) इंजन के साथ पार्स करता है:

कोई भी गैर-चयन उत्परिवर्तन कथन (INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE) को HTTP 400 के साथ तुरंत खारिज कर दिया जाता है।
सिस्टम कैटलॉग तालिकाएँ (pg_catalog, information_schema) सख्ती से अस्वीकृत हैं।
यदि मॉडल LIMIT क्लॉज को छोड़ देता है, तो सर्वर LIMIT 100 (1000 पर कैप्ड) इंजेक्ट करता है और limit_injected: true को चिह्नित करता है।

v1.0 · संशोधित 31 अक्टू॰ 2026
↗ ओपनएपीआई विशिष्टता↗ गिटहब

← पिछला

RAG query & ingest