النقاط الرئيسية
- 01يدعم PostgreSQL و MySQL و SQLite و BigQuery و SQL القياسي مع معالجة الكلمات الرئيسية الواعية بالنهجة.
- 02اختر حالة الكلمات الرئيسية (UPPERCASE أو lowercase أو preserve) والمسافة البادئة (مسافتان أو أربع مسافات أو علامات تبويب).
- 03يعمل بالكامل في متصفحك — الاستعلامات ذات البيانات الحساسة لا تترك جهازك.
- 04تعيد الأداة تنسيق النص فقط؛ لا تنفذ الاستعلامات ولا تتصل بأي قاعدة بيانات.
لماذا تنسق SQL قبل مشاركته؟
SQL غير المنسقة صعبة جداً للمراجعة. قوائم SELECT الطويلة المسحوقة على سطر واحد والمسافة البادئة غير المتسقة في استعلامات فرعية والكلمات الرئيسية المختلطة جميعها تبطئ مراجعات الكود وتصحيح الأخطاء. يجعل استعلام منسق بشكل صحيح شروط JOIN وجملات WHERE وهيكل CTE قابلة للقراءة على الفور.
يصبح التنسيق أكثر أهمية عند مشاركة الاستعلامات عبر فريق بدليل نمط — UPPERCASE للكلمات الرئيسية ومسافة بادئة بأربع مسافات وجملة واحدة لكل سطر. ينفذ منسق SQL في Handytool هذا النمط بشكل متسق على كل ما تصقه، سواء كان بحثاً عن سطرين أو استعلام تحليلي بـ 200 سطر مع عدة CTEs ووظائف نافذة.
كيفية تنسيق استعلام SQL
- 01
الصق SQL الخاص بك
الصق أي تصريح SQL في لوحة الإدخال — SELECT أو INSERT أو UPDATE أو DELETE أو CREATE أو سلسلة CTE كاملة. لا حد للحجم إلى ما وراء ذاكرة متصفحك المتاحة.
- 02
حدد النهجة
اختر PostgreSQL أو MySQL أو SQLite أو BigQuery أو SQL القياسي من القائمة المنسدلة. تحدد النهجة كيفية التعامل مع الكلمات المحفوظة وصيغة خاصة بالبائع مثل RETURNING أو STRUCT.
- 03
عين حالة الكلمات الرئيسية والمسافة البادئة
اختر UPPERCASE أو lowercase أو Preserve لحالة الكلمات الرئيسية. اختر مسافتان أو أربع مسافات أو علامات تبويب للمسافة البادئة. UPPERCASE الكلمات الرئيسية مع المسافة البادئة 2 هو النمط الأكثر شيوعاً في قواعد البيانات المشتركة.
- 04
انقر فوق التنسيق
يظهر الإخراج المنسق في اللوحة اليمنى على الفور. يتم وضع الجملات على أسطرها الخاصة، وتتم محاذاة شروط JOIN، والاستعلامات الفرعية مسافة بادئة نسبة إلى الأب.
- 05
انسخ واستخدم
انقر فوق نسخ لنسخ SQL المنسقة إلى الحافظة. الصقها في IDE أو ملف SQL أو وصف PR أو مقطع توثيق.
آمن للاستخدام مع أنماط استعلام الإنتاج
تعمل مكتبة sql-formatter بالكامل في متصفحك. لا يتم إرسال أي شيء إلى خادم — لا نص استعلام ولا أسماء جداول ولا بيانات عينة. هذا يجعلها آمنة لتنسيق الاستعلامات التي تشير إلى أسماء مخطط حقيقي أو تحتوي على قيم عينة من قاعدة بيانات المرحلة.
هناك شيء واحد لن يفعله منسق SQL هو تنفيذ SQL الخاص بك. إنها أداة تحويل نصية فقط. يمكنك بأمان الصق الاستعلامات التي ستسقط الجداول أو تحذف الصفوف — تعامل الأداة معها كنص عادي وتعيد تنسيقها دون تشغيل بيان واحد.
أسئلة شائعة حول منسق SQL
أي لهجات SQL يدعمها هذا المنسق؟
SQL القياسي و PostgreSQL و MySQL و SQLite و BigQuery. تتعامل كل نهجة مع الصيغة الخاصة بالبائع مثل جملة RETURNING في PostgreSQL ومعرفات حروف backtick في MySQL ونوع STRUCT في BigQuery بشكل صحيح.
هل سيقوم المنسق بتشغيل استعلامي؟
لا. يعيد تنسيق نص الاستعلام فقط. لا يتصل بأي قاعدة بيانات أو يتحقق من أسماء الأعمدة أو ينفذ البيانات.
هل يتم تحميل SQL الخاص بي إلى أي خادم؟
لا. تعمل مكتبة sql-formatter في متصفحك. يبقى نص الاستعلام على جهازك.
لماذا تنسيق أجزاء إجراء مخزن أو كتلة PL/pgSQL بشكل غريب؟
كتل SQL الإجرائية (كتل PL/pgSQL و BEGIN…END و أقسام DECLARE) خارج ما يغطيها نحو المنسق. قم بتنسيق أجزاء SELECT أو DML أصغر من داخل تلك الكتل بشكل منفصل.
ما هي أفضل حالة للكلمات الرئيسية لقاعدة بيانات مشتركة؟
UPPERCASE للكلمات الرئيسية هي الاتفاقية الأكثر اعتماداً على نطاق واسع — فهي تفصل بصرياً هيكل SQL عن أسماء المعرفات. المسافة البادئة بمسافتين أو أربع مسافات هي مسألة تفضيل الفريق.