منسق SQL

كيف تنسّق استعلام SQL

1. الصق استعلامًا واحدًا أو أكثر، أو انقر فتح ملف لتحميل ملف .sql (حتى 10 MB).
2. اختر اللهجة الخاصة بقاعدة بياناتك، مثل PostgreSQL أو MySQL أو SQL Server ‏(T-SQL).
3. حدّد طريقة كتابة الكلمات المفتاحية (أحرف كبيرة، أو أحرف صغيرة، أو كما كُتبت) والمسافة البادئة.
4. فعّل خيار دون مسافات حول العوامل إن كنت تفضّل a=b+1 على a = b + 1.
5. انقر تنسيق SQL، ثم انسخ النتيجة أو نزّلها. أي تغيير في الخيارات يعيد تنسيق الاستعلام تلقائيًا.

يُعاد ترتيب الاستعلام كنص فقط: لا يُنفَّذ أبدًا، ولا يُرسل إلى أي قاعدة بيانات أو خادم.

ماذا يفعل المنسق؟

تعتمد هذه الأداة على مكتبة sql-formatter مفتوحة المصدر. فهي تقسم كل عبارة إلى مقاطع، وتضع كل كلمة مفتاحية للمقطع (SELECT وFROM وWHERE وGROUP BY وORDER BY…) في سطر مستقل، مع إزاحة محتوى المقطع تحتها. توضع أعمدة قائمة SELECT عمودًا في كل سطر، وتبدأ شروط AND وOR أسطرًا جديدة، وتُزاح الاستعلامات الفرعية وتعابير CASE بحسب مستوى التداخل. أما التعابير القصيرة بين الأقواس فتبقى في سطر واحد، وتُفصل العبارات المتعددة المنتهية بفاصلة منقوطة بسطر فارغ.

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

لماذا تهمّ اللهجة؟

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

• تُقتبس المعرّفات بعلامتي "double quotes" في SQL القياسية وPostgreSQL، وبـ `backticks` في MySQL وMariaDB وBigQuery، وبـ [brackets] في SQL Server؛
• بعض العوامل، مثل ->> وتحويلات :: في PostgreSQL أو الوصول إلى المسارات بـ : في Snowflake، لا توجد إلا في لهجات معيّنة؛
• تختلف رموز المعاملات: ? أو $1 أو :name أو @name؛
• لكل لهجة كلماتها المحجوزة ودوالها الخاصة، وهي التي يطبَّق عليها خيار الكلمات المفتاحية.

إذا ظهرت رسالة «تعذّر تحليل الاستعلام»، فتأكّد أولًا من أن اللهجة المختارة تطابق قاعدة بياناتك. تُظهر رسالة الخطأ السطر والعمود اللذين توقّف عندهما التحليل. خيار SQL القياسية هو الأكثر صرامة، لذا اختر قاعدة بياناتك الفعلية كلما أمكن.

نصائح حول حالة الأحرف والأسلوب

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