ForHosting KIT · قراءة المواقع ومراقبتها

نسّق SQL واعرض الاستعلامات بصورة واضحة

حوّل استعلام SQL مضغوطاً أو غير متّسق الأسلوب إلى صيغة سهلة القراءة، بكلمات محجوزة كبيرة ومسافات متوقعة وإزاحة منظّمة.

● Betaمجاني · داخل متصفحك

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

ينفّذ المنسّق تحليلاً معجمياً حتمياً، ولذلك يحافظ على السلاسل والمُعرّفات الواقعة بين علامات الاقتباس، ويجعل الجمل والتعبيرات المتداخلة أسهل للمراجعة. كما يفحص البنية قبل إنتاج المخرجات؛ فيرفض الأقواس التي لا يقابل بعضها بعضاً، والقيم النصية غير المكتملة، والمُعرّفات المقتبسة غير المغلقة. يمكنكم استخدامه مباشرة في المتصفح أو أتمتة السلوك نفسه عبر API مقابل $0.002 لكل طلب.

ما الذي يغيّره المنسّق وما الذي يحافظ عليه

يحوّل المنسّق كلمات SQL المحجوزة التي يتعرّف إليها إلى أحرف كبيرة، ويفصل الجمل الأساسية مثل SELECT وFROM وWHERE وGROUP BY وORDER BY وHAVING وLIMIT وأنواع JOIN الشائعة في أسطر واضحة. تفصل الفواصل عناصر القوائم، بينما تضيف الأقواس مستوى من الإزاحة إلى التعبيرات المتداخلة والاستعلامات الفرعية. وتحصل المعاملات على مسافات موحّدة حولها. في المقابل، يُعامل المحتوى المحدّد بعلامات على أنه محمي؛ فتحافظ النصوص بين علامتي اقتباس مفردتين، والمُعرّفات بين علامتي اقتباس مزدوجتين أو علامتي backtick، والمُعرّفات بين قوسين مربعين على حروفها وحالتها الأصلية. وتبقى تعليقات السطر وتعليقات الكتلة في المخرجات أيضاً. يسهّل ذلك مراجعة الاستعلام من دون افتراض أي شيء عن مخطط قاعدة البيانات. والتنسيق حتمي عن قصد، أي إن الإدخال نفسه ينتج المخرج نفسه دائماً، من دون اتصال بالشبكة أو تفسير من نموذج أو اختيار عشوائي أو اعتماد على البيئة. تُعاد النتيجة في الحقل formatted_sql كنص عادي يمكنكم نسخه إلى محرر أو ترحيل أو تقرير أو مراجعة للشيفرة.

كيف يحمي التحقق البنيوي صحة النتيجة

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

استخدام SQL المنسّق ضمن سير عمل موثوق

الصقوا الاستعلام كاملاً في الحقل query وأرسلوه كسلسلة نصية. عند الاستخدام التفاعلي، قارنوا النتيجة المنسّقة بالأصل قبل استبدال شيفرة الإنتاج، وخصوصاً إذا كانت العبارة تستخدم معاملات خاصة بمورّد معين أو قواعد اقتباس غير مألوفة. وفي الأتمتة، شغّلوا المنسّق قبل حفظ عمليات الترحيل المولّدة، أو إرفاق SQL بتذاكر المراجعة، أو مقارنة التغييرات بين الاستعلامات. يقلّل التخطيط المتّسق ضوضاء الفروق، فيتمكّن المراجعون من التركيز على عمليات الربط والشروط والأعمدة المختارة والترتيب بدلاً من مناقشة حالة الأحرف والمسافات. وبما أن التعليقات والقيم المقتبسة تبقى محفوظة، تصلح النتيجة للتوثيق والتنفيذ، لكن التنسيق لا يغني أبداً عن تحقق قاعدة البيانات واختباراتها. تستخدم أداة المتصفح الدالة النقية نفسها التي تستخدمها API، فتظل النتائج متطابقة. تبلغ كلفة API مقدار $0.002 لكل طلب. تُعالج المدخلات من دون خدمات خارجية، ولا توجد حاجة للاحتفاظ بالاستعلام بعد الرد. إذا فشل التحقق، فأصلحوا العلامة التي لا مقابل لها ثم أرسلوا العبارة الكاملة من جديد.

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

تنظيم SQL المولّد

حوّلوا استعلاماً في سطر واحد صادرًا عن ORM أو سجل أو أداة تقارير إلى تخطيط أسهل للفحص والمناقشة.

توحيد مراجعات الترحيل

طبّقوا حالة أحرف وإزاحة متوقعتين قبل المراجعة لتقليل الفروق التي تتعلق بالشكل وحده.

اكتشاف الاستعلامات الملصقة غير المكتملة

ارفضوا SQL المنسوخ مع قوس أو علامة اقتباس مفقودة قبل نشره في وثيقة أو تمريره إلى نظام آخر.

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

هل ينفّذ المنسّق SQL؟

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

كيف يتعامل مع حالة الأحرف؟

يحوّل كلمات SQL المحجوزة المعروفة إلى أحرف كبيرة، ويحافظ على الحالة الأصلية للنصوص والمُعرّفات المقتبسة.

ما العناصر التي يتحقق منها؟

يرفض الأقواس غير المتقابلة، وعلامات الاقتباس المفردة أو المزدوجة غير المغلقة، والمُعرّفات غير المكتملة بين علامتي backtick أو قوسين مربعين، وتعليقات الكتلة غير المنتهية.

هل يدعم جميع لهجات SQL؟

ينسّق بناء SQL الشائع من دون اختيار لهجة. ويحافظ على التركيبات الخاصة بالمورّدين، لكنه لا يصادق على دلالتها.

كم تبلغ كلفة API؟

تبلغ الكلفة $0.002 لكل طلب. وتنفّذ نسخة المتصفح منطق التنسيق الحتمي نفسه.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/web/sql-format

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

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

curl -X POST https://api.kit.forhosting.com/web/sql-format \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.active=true group by u.id,u.name order by orders desc;"}'

const res = await fetch("https://api.kit.forhosting.com/web/sql-format", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "query": "select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.active=true group by u.id,u.name order by orders desc;"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/sql-format",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "query": "select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.active=true group by u.id,u.name order by orders desc;"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/sql-format", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"query":"select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.active=true group by u.id,u.name order by orders desc;"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"query":"select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.active=true group by u.id,u.name order by orders desc;"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/sql-format", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "query": "select u.id,u.name,count(o.id) as orders from users u left join orders o on o.user_id=u.id where u.active=true group by u.id,u.name order by orders desc;"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

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

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