ForHosting KIT · أدوات المطورين

كيف تكتب استعلام SQL دون تعلّم صيغته؟

أداة تحويل السؤال إلى SQL تأخذ سؤالك المكتوب بلغة عادية، مثل «أعطني عملاء لم يشتروا منذ 3 أشهر»، وتحوّله إلى استعلام SQL جاهز يطابق بنية جدولك إن وصفتها. تناسب من يحتاج تقريرًا سريعًا من قاعدة بيانات دون معرفة صيغة SQL، وهي حاليًا في مرحلة تجريبية تستحق مراجعة الناتج قبل تنفيذه.

● Betaلكل طلب · لكل استعلام$0.003

تشغيل — $0.003 + $0.0135/استعلام اطّلع على الـAPI

استخدمها من الويبAPIالبريدالتطبيق قريبًاTelegram قريبًا

شغّلها أونلاين

شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.

من الجملة العادية إلى الاستعلام

تكتب سؤالك بلغة عادية — «أعطني أكثر 10 منتجات مبيعًا الشهر الماضي» مثلًا — فتحوّله الأداة إلى استعلام SQL مكافئ جاهز للنسخ إلى نظام قاعدة البيانات لديك. كلما وصفت المطلوب بدقة أكبر — الفترة الزمنية، اسم الحقل، ترتيب النتائج — اقترب الاستعلام الناتج من الشكل الذي تحتاجه فعلًا دون تعديل إضافي. الأداة لا تتصل بقاعدة بياناتك ولا تنفّذ الاستعلام؛ تكتفي بإنتاج نص الاستعلام نفسه، فتبقى أنت من يقرر متى وأين يُنفَّذ.

لماذا وصف الجداول يرفع الدقة

من غير وصف لبنية جداولك — أسماء الجداول والأعمدة ونوع كل حقل — تخمّن الأداة تسمية معقولة قد لا تطابق قاعدة بياناتك الفعلية. أرفق مخططًا مختصرًا (مثلًا: جدول orders يحوي customer_id وorder_date ومبلغ الفاتورة) ليستخدم الاستعلام الناتج الأسماء الصحيحة تمامًا. هذا الوصف يمكن إعادة استخدامه في كل سؤال لاحق على نفس قاعدة البيانات، فلا تحتاج كتابته من جديد كل مرة، ويمكن حفظه جانبًا كملف مرجعي لفريقك.

السعر لكل استعلام

السعر معلن: $0.003 لكل طلب زائد $0.0135 لكل استعلام تُنتجه الأداة، أي نحو $0.0165 للاستعلام الواحد، دون اشتراك شهري ودون حد أدنى على عدد الطلبات. طلب يضم خمسة استعلامات مختلفة دفعة واحدة يكلف نحو $0.07، وعشرة استعلامات في يوم عمل واحد تكلف أقل من $0.17 إجمالًا. الدفع عبر PayPal، وبديل التواصل المباشر عبر واتساب أو البريد متاح دائمًا لمن يفضّله. مقارنة بوقت البحث اليدوي عن الصيغة الصحيحة في توثيق SQL، الفارق في الوقت يستحق هذا السعر الرمزي.

مرحلة تجريبية: راجع قبل التنفيذ

الأداة اليوم في مرحلة تجريبية (beta)، فالاستعلام الناتج مسودة جيدة توفر وقتًا لا بديل جاهز للتنفيذ الأعمى على قاعدة إنتاج حقيقية. راجع أسماء الحقول والشروط قبل التشغيل، خصوصًا في استعلامات الحذف أو التعديل التي قد تؤثر في بيانات حقيقية؛ ننصح باختبار أي استعلام من هذا النوع على نسخة تجريبية من القاعدة أولًا، لا على بيانات العملاء الفعلية مباشرة. مع الوقت، تكرار الاستخدام على نفس بنية الجداول يرفع دقة النتائج ويقلل الحاجة لمراجعة طويلة في كل مرة، خصوصًا بعد أن تعتاد الأداة على أسماء حقولك المتكررة.

حالات الاستخدام

تقرير مبيعات دون طلب من قسم البرمجة

سارة النعيمي، مسؤولة مبيعات في شركة الواحة للتجارة المحدودة، تكتب سؤالها بالعربية عن أكثر المنتجات مبيعًا هذا الربع وتحصل على استعلام جاهز بدل انتظار مطوّر مشغول.

تعلّم بنية قاعدة بيانات جديدة

مطوّر ينضم حديثًا إلى فريق في مؤسسة النخيل للمقاولات يستخدم الأداة لفهم كيفية كتابة استعلامات شائعة على قاعدة بيانات ضخمة ورثها من فريق سابق.

تحليل سريع قبل اجتماع

قبل اجتماع إدارة، يطلب محلل بيانات استعلامًا سريعًا لعدد الطلبات المتأخرة عن موعد التسليم دون كتابة SQL من الصفر.

الأسئلة الشائعة

هل تنفّذ الأداة الاستعلام على قاعدتي مباشرة؟

لا، تُنتج نص الاستعلام فقط؛ أنت من ينسخه وينفّذه على نظامك، فلا اتصال مباشر بقاعدة بياناتك في أي وقت.

ما صيغ SQL المدعومة؟

الاستعلام الناتج يتبع صيغة SQL القياسية المتوافقة مع أغلب الأنظمة الشائعة؛ قد يحتاج تعديلات طفيفة حسب نظامك تحديدًا.

لماذا الأداة في مرحلة تجريبية؟

لأن دقة الاستعلام تعتمد على وضوح وصف الجداول المُرفق؛ نواصل تحسين النتائج، وننصح بمراجعة كل استعلام قبل تنفيذه.

هل تُحفظ بيانات جداولي التي أصفها؟

لا، يُستخدم الوصف لإنتاج الاستعلام فقط ولا يُحفظ بعد اكتمال الطلب.

كم سعر الاستعلام الواحد؟

نحو $0.0165 للاستعلام الواحد: $0.003 للطلب زائد $0.0135 للاستعلام.

هل أحتاج معرفة برمجية لاستخدامها؟

لا، تكتب سؤالك بلغة عادية؛ معرفة SQL مسبقة غير ضرورية لاستخدام الأداة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/dev/text-to-sql

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/dev/text-to-sql \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/text-to-sql", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/text-to-sql",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/text-to-sql", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/text-to-sql", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "input": "…"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.text_to_sql",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.003

لكل استعلام$0.0135

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.
`422`	`task_failed`	لم تنجح معالجة المهمة، ولن تُحتسب عليك؛ أعد المحاولة أو راسلنا مباشرة.

اطّلع على توثيق KIT الكامل ←