منسّق SQL

كيف يعمل المنسّق؟

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

ما الذي يبقى كما هو؟

• النصوص بين علامتَي اقتباس مفردة، بما فيها 'don''t''a, b (c)'
• النصوص المغلقة بعلامة $$ في PostgreSQL
• الأسماء المحاطة بعلامة backtick أو بعلامتَي اقتباس مزدوجتين
• الأسماء المؤهَّلة بنقطة مثل t.value وu.created_at

ما الذي يتغيّر؟

• الكلمات المحجوزة تصبح بأحرف كبيرة إن فعّلت الخيار
• تبدأ SELECT وFROM وWHERE في أسطر مستقلة
• AND وOR وON تنتزل سطراً وتزداد إزاحة بمقدار مستوى
• المحتوى بين قوسين يزداد تداخلاً، وEND في CASE يرجع للتساوي

قبل وبعد

-- قبل
select u.id, count(o.id) as total
from users u left join orders o on o.user_id = u.id
where u.active = true group by u.id

-- بعد
SELECT u.id, count(o.id) AS total
FROM users u
LEFT JOIN orders o
  ON o.user_id = u.id
WHERE u.active = TRUE
GROUP BY u.id;

متى أستخدم الضغط؟

عند وضع الاستعلام داخل كود أو في حقل text محدود، أو عند مقارنة حجم استعلام قبل وبعد التحسين. الضغط يحذف التعليقات والمسافات ويصل المسافات بين الكلمات، ولا يضيف أي رموز جديدة ولا يحذف الفاصلة المنقوطة الموجودة، ودون المساس بالمعاملات مثل >= و<>.

ملاحظة على الأسماء المحجوزة

الكلمات المحجوزة مثل key وend تُعامل ككلمات محجوزة، لأنها كذلك في SQL. إن كان اسم عمودك واحداً منها، اضبطه بين backtick ليُحفظ كما هو.