منسّق SQL

اختيار اللهجة

تحدد اللهجة طريقة قراءة علامات الاقتباس والعناصر النائبة. يضع MySQL وBigQuery معرفات الجداول والحقول بين علامات اقتباس عكسية، بينما يستخدم PostgreSQL وSQL القياسي علامات اقتباس مزدوجة. وتختلف العناصر النائبة أيضاً: $1 في PostgreSQL، و? في MySQL وSQLite، و@name في BigQuery. اختر قاعدة البيانات التي يعمل عليها الاستعلام، لأن العنصر النائب أو علامة الاقتباس التي لا تعرفها اللهجة قد تمنع التنسيق.

تُكتب الكلمات المفتاحية بأحرف كبيرة فقط. وتحتفظ أسماء الجداول والأعمدة بحالة أحرفها، وهذا مهم في PostgreSQL، حيث تكون الأسماء الموضوعة بين علامات اقتباس حساسة لحالة الأحرف.

عندما يفشل التنسيق

يعني خطأ التحليل عادةً أن النص ليس SQL خالصاً. فالقوالب من dbt أو Jinja أو ORM، مثل {{ ref('orders') }} أو {% if %}، توقف المحلل عند ذلك الموضع؛ نسّق SQL المجمّع بدلاً من ذلك، أو استبدل أجزاء القالب بأسماء عناصر نائبة أولاً.

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

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

1. ألصق SQL واختر لهجة.
2. نسّق العبارة.
3. انسخ النتيجة المقروءة أو نزّلها.

الخصوصية والقيود

تبقى الاستعلامات في المتصفح. لا يتحقق التنسيق من مخطط قاعدة البيانات أو الأذونات أو أداء الاستعلام.