تنسيق 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.created_at>='2024-01-01' GROUP BY u.id,u.name HAVING COUNT(o.id)>5 ORDER BY orders DESC LIMIT 50;

بعد (فواصل أولية، كلمات مفتاحية كبيرة الحروف، انزياح بمقدار فاصلين):

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.created_at >= '2024-01-01'
GROUP BY u.id, u.name
HAVING COUNT(o.id) > 5
ORDER BY orders DESC
LIMIT 50;

خيارات النمط المهمة

• الكلمات المفتاحية بأحرف كبيرة مقابل أحرف صغيرة: تُعد الأحرف الكبيرة تقليدية وسهلة التعرف عليها أثناء المسح البصري، بينما تكون الأحرف الصغيرة أكثر وضوحًا في محررات الكود الحديثة التي تُبرز تلوين البنية النحوية.
• الفاصلة في البداية مقابل الفاصلة في النهاية: تُسهّل الفاصلة في البداية ( , col) تعطيل عمود واحد كتعليق، بينما تبدو الفاصلة في النهاية (col,) أكثر طبيعية عند قراءتها في النص.
• ترتيب الفواصل في GROUP BY: عادةً تُوضع فاصلة واحدة لكل سطر في الجُمَل الطويلة، وتُكتب ضمن السطر نفسه في الجُمَل القصيرة.
• إزاحة عبارات JOIN: هل تُكتب ON في السطر التالي (إزاحة معلّقة) أم على السطر نفسه؟ تستفيد الشروط الطويلة من الإزاحة المعلّقة.
• الاستعلامات الفرعية: أزِح الاستعلام الفرعي بأكمله، وليس قوس الفتح فقط.

الأخطاء الشائعة الخاصة بكل لهجة

• علامات الاقتباس العكسية (backticks) في MySQL مقابل علامات الاقتباس المزدوجة في PostgreSQL للمُعرِّفات.
• عبارات WITH (CTEs): يشترط نظام MS SQL وجود ; قبل WITH؛ ويتولى أداة التنسيق معالجة هذا الشرط.
• دوال النوافذ: تستفيد عبارات OVER (...) الطويلة من توزيع PARTITION BY وORDER BY على أسطر متعددة.
• BigQuery: يحتوي على ARRAY_AGG وSTRUCT ولواحق الجداول (مثل *_yyyymmdd)، ويجب على أداة التجزئة عدم كسرها.
• Oracle: يستخدم صيغة الربط الخارجي (+)؛ تحافظ أداة التنسيق على هذه الصيغة لكنها تصنّفها كصيغة قديمة.

ما لا تقوم به أداة التنسيق

• تصحيح الأخطاء: يظل عملية JOIN غير الصالحة غير صالحة.
• توسيع SELECT *: لا تُستنتج قوائم الأعمدة من المخطط.
• تحسين الاستعلامات: التخطيط فقط، وليس خطط التنفيذ.
• إعادة كتابة الاستعلامات الفرعية على شكل عبارات CTE: وهي مسألة مختلفة تمامًا.