تنسيق SQL أونلاين — ترتيب الاستعلامات وإضافة المسافات البادئة

ما هذه الأداة؟

الاستعلام المنسوخ من سجل أو من ORM يصل غالبًا في سطر واحد طويل أو بمسافات بادئة غير متسقة، فتصعب قراءته ومراجعته. تقسّم هذه الأداة SQL إلى عبارات مثل SELECT وFROM وWHERE وتضيف مسافات بادئة متسقة، وتتحدث النتيجة أثناء الكتابة.

طريقة الاستخدام

1. الصق SQL في خانة الإدخال. لا مشكلة في عدة عبارات يفصل بينها فاصلة منقوطة.
2. اختر اللهجة المطابقة لقاعدة بياناتك.
3. اختر أحرفًا كبيرة أو صغيرة للكلمات المفتاحية أو أبقها كما كُتبت.
4. اختر مسافة بادئة من مسافتين أو 4 مسافات أو Tab وانسخ النتيجة.

كيف تعمل؟

• يتولى التنسيق المكتبة مفتوحة المصدر sql-formatter. تقسّم المدخلات إلى رموز، ثم تحدد الأسطر الجديدة والمسافات البادئة بحسب العبارة وعمق الأقواس.
• اللهجات المدعومة: Standard SQL وMySQL وPostgreSQL وMariaDB وSQLite وBigQuery وOracle (PL/SQL) وSQL Server (T-SQL). وتغيّر اللهجة طريقة قراءة علامات اقتباس المعرّفات (` و" و[ ]) وعلامات المعاملات (? و$1 و@name) والعوامل.
• عناصر MyBatis النائبة #{id} و#{name,jdbcType=VARCHAR} و${table} تبقى كما هي في كل اللهجات. في MySQL يبدأ # عادةً تعليقًا، لكن #{ يُعامل كعنصر نائب. والعنصر النائب الممتد على عدة أسطر يُحفظ أيضًا، أما الأقواس المتداخلة مثل #{list[${i}]} فغير مدعومة.
• معاملات الربط: ? و:name في Standard SQL وMySQL وMariaDB، و$1 و:name في PostgreSQL، و:name في Oracle، و@name في SQL Server وBigQuery، ويقبل SQLite كلًا من ? و?1 و:name و@name و$name.
• تذكر الأخطاء السطر والعمود والنص الذي توقف عنده التحليل.
• خيار حالة الأحرف يطبَّق على الكلمات المحجوزة فقط. النصوص الحرفية والتعليقات والمعرّفات، بما فيها أسماء الجداول والأعمدة المكتوبة بالعربية، لا تتغير.
• خيار Tab يستخدم حرف Tab واحدًا لكل مستوى.
• الأداة تعيد التنسيق فقط، فلا تنفّذ الاستعلام ولا تتحقق من معناه.

أمثلة

المدخلات:

select id, name from users where age > 20 and city = 'الرياض' order by name

النتيجة (Standard SQL، أحرف كبيرة، مسافتان):

SELECT
  id,
  name
FROM
  users
WHERE
  age > 20
  AND city = 'الرياض'
ORDER BY
  name