منسّق SQL

ما الذي تفعله الأداة

يحوّل منسّق SQL الاستعلام الطويل المكتوب في سطر واحد إلى استعلام مقروء بمسافات بادئة متسقة. تبدأ كل عبارة (SELECT وFROM وWHERE وGROUP BY وORDER BY) في سطر مستقل، وتُدرج الأعمدة المختارة والشروط بواحد في كل سطر، وتصطف عمليات الربط (joins) تحت الجدول الذي تربطه، وتُزاح الاستعلامات الفرعية داخل أقواسها.

استعلامات SQL المنسّقة أسهل في المراجعة ضمن طلبات الدمج (pull requests)، وفي التصحيح عندما يُرجع الاستعلام صفوفًا خاطئة، وفي اللصق داخل التوثيق. كما تفيد عندما تنسخ استعلامًا من سجل ORM أو من رسالة خطأ في تطبيق، حيث يكون كل شيء في سطر واحد.

طريقة الاستخدام

1. الصق عبارة SQL واحدة أو أكثر في مربع الإدخال، أو أفلت عليه ملف .sql، أو انقر مثال.
2. اختر اللهجة الخاصة بقاعدة بياناتك.
3. اختر الكلمات المفتاحية بصيغة UPPERCASE أو lowercase، أو أبقِها كما كُتبت. تتبع أسماء الدوال مثل COUNT الإعداد نفسه.
4. اختر مسافتين أو 4 مسافات أو Tab لـ المسافة البادئة.
5. انسخ النتيجة أو نزّلها كملف .sql. الاختصارات: Ctrl/Cmd+Enter للتنسيق، وCtrl/Cmd+Shift+C للنسخ.

تُفصل العبارات المتعددة المفصولة بفواصل منقوطة بسطر فارغ. وتبقى التعليقات في مواضعها.

مثال

select u.id, count(o.id) as orders from users u left join orders o on o.user_id = u.id group by u.id

يصبح

SELECT
  u.id,
  COUNT(o.id) AS orders
FROM
  users u
  LEFT JOIN orders o ON o.user_id = u.id
GROUP BY
  u.id

نصائح

الكلمات المفتاحية بالأحرف الكبيرة تجعل العبارات بارزة عن أسماء الجداول والأعمدة، وهذا هو العرف الأكثر شيوعًا في الفرق. إذا كان فريقك يكتب SQL بأحرف صغيرة، فاختر lowercase وسيتطابق الاستعلام كله. وإذا أبلغ المنسّق عن رمز غير متوقع، فتحقق من صحة اللهجة: فمثلًا الأسماء المحاطة بعلامات backtick صالحة في MySQL لكنها غير صالحة في SQL القياسية.