منسق/محسن SQL

منسق/محسن SQL أداة مجانية تستقبل شيفرة SQL وتعيدها بتنسيق متسق وأسهل للقراءة.

ما الذي يتغير عند تنسيق SQL؟

يغير تنسيق SQL طريقة عرض الاستعلام لتسهيل تتبع عباراته وتعبيراته وبناه المتداخلة. ويضيف عادة فواصل أسطر ومسافات بادئة حول عناصر مثل قوائم SELECT وعبارات JOIN وشروط WHERE والاستعلامات الفرعية وتعبيرات CASE.

يجب ألا يغير التنسيق النتيجة المقصودة من الاستعلام. لكن لهجات SQL تختلف، ولا يكفي التنسيق وحده لإثبات احتفاظ العبارة بمعناها. راجع SQL الناتج قبل تشغيله على بيانات الإنتاج، خاصة إذا كان يستخدم معاملات خاصة بجهة مزودة، أو امتدادات إجرائية، أو قواعد اقتباس غير معتادة.

يفيد المنسق عند قراءة استعلامات كتبها آخرون، أو مراجعة SQL مولد آليا، أو تصحيح عبارة طويلة، أو تجهيز الشيفرة لطلب دمج. كما يسهل التنسيق المتسق مقارنة التغييرات لأنه يقلل فروق المسافات غير المرتبطة بالتعديل.

كيف أستخدم منسق SQL؟

الصق العبارة أو أدخلها في حقل SQL، ثم أرسلها لتحصل على النسخة المنسقة في SQL مُحَسَّن. يُرسل الإدخال إلى الخادم عبر HTTPS لمعالجته ولا يُخزن.

1. انسخ العبارة كاملة، بما في ذلك أي تعبيرات جدول شائعة تريد الاحتفاظ بها، ثم تحقق من التعليقات ومن وجود أي فاصلة منقوطة ختامية في النتيجة.
2. أدخلها في حقل SQL بدلا من تنسيق أجزاء منفصلة، متى أمكن ذلك.
3. راجع النتيجة في SQL مُحَسَّن، وركز خصوصا على التعبيرات المتداخلة والصياغة الخاصة بلهجة SQL المستخدمة.
4. شغل العبارة المنسقة في بيئة تطوير أو اختبار مرحلي مناسبة قبل نشرها.

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

كيف أقرأ SQL بعد تحسين تنسيقه؟

اقرأ النتيجة بتتبع المسافات البادئة وحدود العبارات، ولا تعتبر التخطيط الجديد دليلا على صحة العبارة. غالبا ما يسهل تمييز SELECT وFROM وWHERE وGROUP BY وORDER BY في المستوى الأعلى عندما يوضع كل جزء منطقي في سطر مستقل أو على مستوى إزاحة خاص به.

• الاستعلامات الفرعية ذات المسافات البادئة: توضح موضع استخدام نتيجة داخلية ضمن عبارة خارجية.
• الشروط المتراصة: تسهل فحص أولوية AND وOR، مع بقاء AND أعلى أولوية من OR افتراضيا، واستمرار الأقواس في تحديد التجميع المنطقي.
• عبارات JOIN المنفصلة: تساعد على توضيح شرط ON المرتبط بكل جدول.
• قوائم SELECT الموسعة: تسهل ملاحظة الفواصل الناقصة والأعمدة المكررة والأسماء المستعارة الملتبسة.
• فروع CASE الواضحة: تساعد المراجعين على مطابقة الكلمات المفتاحية WHEN وTHEN وELSE وEND.

تحمل السلاسل المقتبسة والأرقام وعلامات الترقيم والتعليقات معنى في SQL، لذا افحصها ولا تفترض أن وجودها يتعلق بطريقة العرض فقط. وقد تكون الأحرف المشكلة أو غير اللاتينية صالحة داخل القيم النصية الحرفية والمعرفات المقتبسة، بحسب قاعدة البيانات وترميز الأحرف فيها.

أمثلة بسيطة على التنسيق

تأمل هذا الإدخال المختصر.

الإدخال: SELECT id,name FROM customers WHERE active=1 ORDER BY name;

يمكن عرض نسخة منسقة سهلة القراءة كما يلي.

الناتج: SELECT id, name

FROM customers

WHERE active = 1

ORDER BY name;

يستفيد الاستعلام الذي يتضمن عملية ربط أكثر من استخدام المسافات البادئة.

الإدخال: SELECT o.id,c.name FROM orders o JOIN customers c ON c.id=o.customer_id WHERE o.total>100;

يمكن أن يضع الناتج السهل القراءة SELECT وFROM وJOIN وON وWHERE في أسطر منفصلة، مع الاحتفاظ بالمقارنة o.total > 100. تختلف الكتابة بالأحرف الكبيرة أو الصغيرة، والمسافات، ومواضع الأسطر بحسب قواعد التنسيق المتبعة، لذا تعامل مع هذه الأمثلة بوصفها تخطيطات ممكنة لا نمطا ثابتا مضمونا.

هل يستطيع التنسيق اكتشاف أخطاء SQL؟

لا، تحسين تنسيق SQL ليس بديلا عن التحقق منه باستخدام محلل قاعدة بيانات. النتيجة المعلنة لهذه الأداة هي SQL منسق، لذلك لا تتعامل معها على أنها مدقق صياغة أو مدقق مخطط قاعدة بيانات أو مخطط تنفيذ.

مع ذلك، قد يكشف التخطيط الأوضح أخطاء محتملة أثناء المراجعة. من الأمثلة الشائعة فاصلة مفقودة في قائمة SELECT، أو أقواس غير متطابقة، أو سلسلة مقتبسة غير منتهية، أو JOIN بلا الشرط المقصود، أو تجميع غير صحيح لتعبير AND أو OR. وقد يسهل أيضا ملاحظة استخدام كلمة محجوزة كمعرف غير مقتبس.

لا يمكن التأكد من بعض المشكلات من دون قاعدة البيانات المستهدفة. فقد تحتاج عبارة تقبلها PostgreSQL إلى تعديلات كي تعمل مع Microsoft SQL Server أو MySQL أو Oracle Database أو SQLite. ويتطلب تشخيص الجداول المفقودة والأعمدة غير المعروفة وأنواع البيانات غير المتوافقة وأخطاء الأذونات عادة محرك قاعدة البيانات أو أداة تطوير تدرك لهجة SQL المستخدمة.

متى لا يكون تنسيق SQL مفيدا؟

لا تكون إعادة التنسيق ضرورية عادة إذا كان SQL منسقا باتساق بالفعل أو كانت آلة وحدها ستستهلكه. وقد تؤدي إعادة تنسيق الاستعلامات المولدة آليا إلى تغييرات مزعجة في نظام التحكم بالمصدر، من دون تحسين الأداة التي أنشأتها.

وقد لا تكون إعادة التنسيق الخطوة المناسبة أيضا في الحالات التالية:

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

لتطبيق تنسيق قابل للتكرار على مستودع كامل، قد يكون منسق سطر أوامر مدرك للهجة SQL أنسب، إذ يمكن حفظ إعداداته مع الشيفرة في المستودع. أما حمولات API المنظمة التي تحتوي على SQL، فيمكن لأداة مدقق ومُجمّل JSON أن تساعد على فحص JSON المحيط به، بينما يظل SQL نفسه بحاجة إلى معالجة مخصصة له.

الأسئلة الشائعة

هل يغير تنسيق SQL طريقة عمل NULL؟

لا تغير المسافات البيضاء والمسافات البادئة منطق SQL ثلاثي القيم أو سلوك NULL. ومع ذلك، تحقق من تعبيرات مثل column = NULL، التي تحتاج عادة إلى IS NULL، لأن المنسق لن يصحح هذا الخطأ الدلالي.

هل يمكنني تنسيق عدة عبارات SQL دفعة واحدة؟

لا يتوفر توثيق يؤكد دعم تنسيق عدة عبارات SQL دفعة واحدة. نسق كل عبارة على حدة.

هل يمكنني إبقاء التعليقات في الإدخال بأمان؟

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

هل أكتب كلمات SQL المفتاحية بأحرف كبيرة أم صغيرة؟

كلا الأسلوبين مقبول عادة، لأن كثيرا من محركات قواعد البيانات لا تراعي حالة الأحرف في الكلمات المفتاحية غير المقتبسة. اتبع النمط المعتمد في المستودع، وانتبه إلى المعرفات المقتبسة لأن بعض قواعد البيانات تحتفظ بحالة أحرفها أو تميز بينها.

ما الذي يجب التحقق منه قبل تشغيل الاستعلام المنسق؟

تأكد من لهجة قاعدة البيانات المستهدفة، وافحص شروط WHERE وJOIN، وتحقق من حدود المعاملات في عبارات UPDATE وDELETE والعبارات التي تغير المخطط. شغل الاستعلامات الخطرة أولا في قاعدة بيانات للتطوير أو الاختبار المرحلي، ويفضل أن تحتوي على بيانات ممثلة مع نسخ احتياطية مناسبة.