كيفية تنسيق استعلامات SQL

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

لماذا التنسيق مهم

• تصحيح الأخطاء — استعلام منسّق جيدًا يجعل أخطاء المنطق مرئية. يمكنك متابعة التدفّق من SELECT إلى WHERE ثم إلى JOIN دون تخمين.
• مراجعة الكود — يقرأ المراجعون SQL المنسَّق في ثوانٍ. يجبرهم استعلام في سطر واحد على تحليله ذهنيًا أولًا.
• الصيانة — عندما تعود إلى استعلام بعد أشهر، يخبرك التنسيق بما يفعله بنظرة واحدة.
• التعاون — التنسيق المتّسق في فريق يعني أن الجميع يقرأ SQL بنفس الطريقة.

كيفية تنسيق SQL

1. الصق SQL الخاص بك — أدخل استعلامًا مصغَّرًا أو فوضويًا في المنسّق. يتعامل مع SELECT وINSERT وUPDATE وDELETE وCREATE TABLE، بالإضافة إلى الاستعلامات المعقّدة بالاستعلامات الفرعية والوصلات.
2. اضبط الخيارات — اختر حجم المسافة البادئة وما إذا كانت الكلمات الرئيسية يجب أن تكون بأحرف كبيرة. تطابق هذه الإعدادات دليل أسلوب مشروعك.
3. انسخ النتيجة — SQL المنسَّق جاهز للصق مرة أخرى في محرّرك أو عميل قاعدة البيانات أو وثائقك.

كيف يبدو التنسيق الجيد

استعلام مثل select u.name, o.total from users u join orders o on u.id = o.user_id where o.total > 100 and u.active = 1 order by o.total desc يصبح:

SELECT
  u.name,
  o.total
FROM users u
JOIN orders o
  ON u.id = o.user_id
WHERE o.total > 100
  AND u.active = 1
ORDER BY o.total DESC

تبدأ كل جملة على سطرها الخاص. تتم المسافة البادئة للشروط تحت جملتها الأم. تُربط الوصلات وشروط ON الخاصة بها بوضوح.

نصائح

• نسّق قبل الإيداع — مرّر SQL الخاص بك عبر منسّق قبل إضافته إلى التحكّم في الإصدار. هذا يحافظ على فروقات نظيفة ويركّز المراجعات على المنطق، وليس على الأسلوب.
• استخدم حالة كلمات رئيسية متّسقة — اختر الأحرف الكبيرة أو الصغيرة والتزم بها في جميع أنحاء مشروعك. تجعل الأنماط المختلطة الاستعلامات صعبة القراءة.
• قسّم الاستعلامات المعقّدة — إذا ظل استعلام صعب القراءة حتى بعد التنسيق، قسّمه إلى CTE (Common Table Expressions) أو طرق عرض. لا يمكن للتنسيق إصلاح منطق معقّد جوهريًا.
• تحقّق من تلوين الصياغة — يقدّم منسّق جيد تلوينًا يميّز بين الكلمات الرئيسية والسلاسل والأرقام، مما يساعد على اكتشاف الأخطاء المطبعية.