منسق استعلامات SQL

منسّق استعلامات SQL يوحّد عبارة SQL وفقاً لنمط قابل للتوقّع ويقلّل الوقت المستغرق في التنسيق اليدوي. يُستخدم من قبل المطورين، مسؤولي قواعد البيانات، مهندسي البيانات ومحللي البيانات لمراجعة أو refactor أو مشاركة الاستعلامات عبر المستودعات. يركّز على المسافة البادئة المتسقة، واستخدام الحروف الكبيرة للكلمات المفتاحية، وقوائم SELECT محاذاة، وانقسامات الأسطر الضيقة، مما يحسن القراءة ويقلل سوء التفسير أثناء مراجعات الشفرة. يتعامل مع عبارات مثل SELECT, FROM, WHERE, GROUP BY, ORDER BY وJOIN، مع الحفاظ على التعليقات والعبارات النصية، بما في ذلك الاستعلامات الفرعية والمتداخلة وCTEs. يمكنه تنسيق عبارات مفردة أو متعددة ويُرجِع مخرجات نظيفة ومعيارية للمراجعات والوثائق.
جوهر المنطق والميزات: يحلل المكوّن SQL إلى تمثيل بنيوي ويطبق قواعد الأسلوب لإنتاج إخراج مقروء. الميزات الأساسية تشمل التنسيق المعتمد على اللهجة، المسافة الصحيحة حول العوامل والحفظ التعليقات والعبارات. الميزات الاختيارية تشمل درجة الإزاحة القابلة للتكوين (مسافات أو علامات جدولة)، تقطيعات الأسطر، حالة الكلمات المفتاحية ووضع مضغوط. يعالج المدخلات متعددة العبارات بتنسيق كل عبارة بشكل مستقل والاحتفاظ بفواصل النقطة والفاصلة؛ تمكّن ملفات تعريف المشروع من اتساق المعايير عبر الفريق.
Inputs & Outputs: إدخال: sql_text (string, required), dialect (ANSI, PostgreSQL, MySQL, T-SQL, Oracle, optional), options (indent_size, wrap_columns, keyword_case). إخراج: formatted_sql (string), diagnostics (list of strings). Diagnostics تشير إلى أنماط غامضة أو تلميحات بناء جملة؛ يعيد الأداة SQL النهائي بتنسيق موحّد وأي diagnostica اختيارية للتكامل في CI، المحررات وسير عملية التوثيق.