مُنسِّق SQL

مُنسِّق يُكبِّر الكلمات المفتاحية بمطابقة كلمات كاملة بتعبير نمطي ليس له طريقة لمعرفة ما إذا كان ظهور معين لكلمة "order" هو الكلمة المفتاحية SQL `ORDER` (كما في `ORDER BY`) أو قيمة سلسلة حرفية يصادف أنها تحتوي تلك الكلمة — استعلام يُصفِّي صفوفًا `WHERE description = 'the order from stock'` يحتوي كلمة "order" داخل سلسلة بعلامات اقتباس، لا تعمل على الإطلاق ككلمة مفتاحية. مُنسِّق ساذج يُكبِّر كل كلمة مطابقة بغض النظر عن السياق، مُفسدًا قيمة السلسلة الحرفية إلى 'the ORDER FROM stock' ويُغيِّر بصمت ما يُصفِّيه الاستعلام فعليًا. تقسيم الاستعلام إلى رموز بشكل صحيح — التعرف على حدود السلاسل بعلامات الاقتباس قبل تحديد ما يُحتسَب ككلمة مفتاحية — هو ما يمنع هذا، وهو بالضبط نوع الخطأ الذي يظهر فقط مع بيانات حقيقية تحتوي كلمات يصادف أنها تطابق كلمات SQL المفتاحية، لذا من السهل تفويته عند الاختبار باستعلامات عينة بسيطة.

تتعرف هذه الأداة على بنية الجُمَل المشتركة بين PostgreSQL وMySQL وSQL Server وSQLite وOracle — SELECT وFROM وWHERE وJOIN وGROUP BY وORDER BY وأقاربها — بشكل جيد بما يكفي لوضع مسافة بادئة لكل جملة في سطرها الخاص وتداخل الاستعلامات الفرعية بشكل صحيح. لا تبني فهمًا كاملًا لقواعد نحوية كاملة لأي قاعدة بيانات معينة، بما في ذلك امتدادات خاصة بمورّد مثل صياغة مصفوفة PostgreSQL أو موضع جملة `TOP` في SQL Server. النتيجة العملية أن الصياغة الخاصة بلهجة معينة تمر عبر المُنسِّق دون لمس بدلًا من التسبب بخطأ، لكنها أيضًا لن تحصل على نفس المسافة البادئة الدقيقة التي تحصل عليها الجُمَل المشتركة — مقايضة معقولة مقابل دعم خمس لهجات بمُنسِّق واحد بدلًا من الحاجة لأداة منفصلة لكل محرك قاعدة بيانات.

الكلمات المفتاحية في SQL غير حساسة لحالة الأحرف بمواصفات اللغة نفسها — `SELECT` و`Select` و`select` متطابقة لأي محرك SQL — وهذا بالضبط ما يجعل تكبيرها أو تصغيرها عملية تجميلية خالصة دون أي خطر لتغيير السلوك. الأمر نفسه ينطبق على المسافات البيضاء والأسطر الجديدة التي يُضيفها هذا المُنسِّق: استعلام مُوزَّع على اثني عشر سطرًا بمسافة بادئة يعمل مطابقًا لنفس الاستعلام مُكدَّسًا في سطر واحد. لا شيء من التنسيق يمس الرموز الفعلية التي تُحدِّد أي الجداول تُقرَأ، أي الشروط تُصفِّي الصفوف، أو أي القيم تُدرَج — فقط كيف تُعرَض بصريًا نفس الاستعلام المنطقي لإنسان يقرأه لاحقًا.

استعلام مُولَّد بواسطة ORM، مُصدَّر من واجهة رسومية لقاعدة بيانات، أو مكتوب كسطر واحد طويل أثناء ترحيل عاجل عادةً صحيح وظيفيًا لكنه صعب حقًا مراجعته لشخص كما هو مكتوب — استعلام بخمسة عشر انضمامًا (join) دون أسطر جديدة يُصعِّب رؤية أي الشروط تنتمي لأي انضمام، أو ما إذا كانت جملة WHERE تُصفِّي الجدول الصحيح. إعادة تنسيقه بحيث تكون كل جملة وكل انضمام في سطره الخاص، بمسافة بادئة تعكس بنية الاستعلام الفعلية، عادةً الطريقة الأسرع لفهم ما يفعله استعلام طويل مُولَّد فعليًا قبل الموافقة عليه في مراجعة كود أو تصحيح لماذا يُعيد الصفوف الخاطئة.