منسق SQL

اجعل كود SQL قابلاً للقراءة

الاستعلامات المنسوخة من السجلات، أو المُولَّدة عبر ORM، أو المكتوبة على عجل، غالباً ما تظهر كسطر واحد طويل يصعب قراءته وتصحيح أخطائه. تقوم أداة تنسيق SQL هذه بتقسيم استعلامك إلى عبارات واضحة — SELECT, FROM, JOIN, WHERE, GROUP BY, ORDER BY — وتضع كل عمود وشرط في سطر مستقل، مع إضافة مسافات بادئة للاستعلامات الفرعية وتعبيرات CASE بشكل متناسق. لتصبح النتيجة أسهل في المراجعة، والمقارنة في أنظمة التحكم في الإصدارات، والمشاركة مع الزملاء.

الميزات

• 12 صيغة SQL، بدءاً من SQL القياسية وحتى MySQL و PostgreSQL و SQL Server و Oracle و BigQuery و Snowflake.
• حالة أحرف الكلمات المفتاحية: كبيرة (UPPER)، أو صغيرة (lower)، أو كما هي مكتوبة؛ ويُطبق ذلك على الكلمات المفتاحية، وأنواع البيانات، والدوال.
• المسافات البادئة باستخدام مسافتين، أو 4 مسافات، أو علامات الجدولة (tabs).
• العبارات المتعددة المفصولة بفواصل منقوطة.
• الاحتفاظ بالتعليقات — سواء تعليقات السطر الواحد -- أو تعليقات الكتل /* */.
• نسخ أو تنزيل النتيجة كملف .sql.
• الخصوصية: تعمل أداة التنسيق محلياً داخل متصفحك.

قبل وبعد

استعلام مثل هذا:

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.status = 'active' group by u.id, u.name order by orders desc;

يصبح هكذا:

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.status = 'active'
GROUP BY
  u.id,
  u.name
ORDER BY
  orders DESC;

نصائح لأسلوب كتابة SQL

• عبارة واحدة لكل سطر. كتابة كل عبارة رئيسية في سطر جديد يجعل بنية الاستعلام واضحة بمجرد النظر.
• استخدم أسماء مستعارة ذات معنى. الأسماء المستعارة القصيرة مثل u و o مناسبة للاستعلامات الصغيرة، لكن الأسماء الوصفية مفيدة في التقارير الطويلة.
• حدد أسماء الأعمدة في عمليات الربط (orders.user_id بدلاً من user_id) لتجنب الغموض.
• حافظ على اتساق التنسيق في جميع أنحاء المشروع حتى تُظهر الفروق التغييرات الحقيقية، وليس المسافات الفارغة.

أدوات ذات صلة

هل تتعامل مع نتائج الاستعلامات؟ حوّل البيانات المُصدّرة باستخدام محول CSV إلى JSON، أو نسّق استجابات API باستخدام منسق JSON، أو قارن بين نسختين من الاستعلام باستخدام أداة مقارنة النصوص.