انتقل إلى المحتوى

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

نسّق استعلامات SQL أو صغّرها لـ MySQL و PostgreSQL و SQL Server و SQLite و BigQuery و Oracle و 14 لهجة أخرى بالنمط الذي تختاره، مباشرة في متصفحك.

منسّق
اضغط «تنسيق SQL» لتنسيق استعلامك.
تعمل في متصفحك · دون رفعكيف يعمل الموقع

طريقة استخدام منسّق SQL

  1. 1

    الصق تعليمات SQL

    الصق استعلامًا أو سكربتًا كاملًا، أو افتح ملفًا بامتداد .sql؛ ويعرض زر المثال استعلامًا غير مرتب للتجربة.

  2. 2

    اختر اللهجة

    حدّد قاعدة بياناتك ليتعرف المنسّق بشكل صحيح على علامات الاقتباس والعوامل والكلمات المفتاحية الخاصة بها.

  3. 3

    اضبط الأسلوب

    اختر حالة أحرف الكلمات المفتاحية والإزاحة وموضع الفواصل والتخطيط بما يوافق الأعراف المتبعة في فريقك.

  4. 4

    نسّق وانسخ

    اضغط «تنسيق SQL» أو زر التصغير، ثم انسخ النتيجة الملوّنة أو نزّلها ملفًا بامتداد .sql.

الحدود وخطة Pro

مجانًا ودون تسجيل: 20 لهجة، وملفات .sql حتى 10 MB، وسكربتات يكتمل تنسيقها خلال 20 ثانية؛ أما المخرجات التي تتجاوز 600,000 حرف فتُعرض معاينة لجزء منها وتُنسخ أو تُنزَّل كاملة.

تزيل Pro الإعلانات؛ أما المنسّق نفسه فهو واحد في كل الخطط. عرض Pro

عن منسّق SQL

الصق استعلامًا مكتوبًا في سطر واحد من سجل، أو من مخرجات التصحيح في ORM، أو من رسالة أرسلها زميل في المحادثة، فيرتبه هذا المنسّق كما يرتبه شخص دقيق: كل عبارة في سطر، والأعمدة المحددة وعمليات الربط مزاحة تحت كلمتها المفتاحية، والاستعلامات الفرعية متداخلة بحيث تظهر البنية من النظرة الأولى. يفهم 20 لهجة من SQL، وهي SQL القياسية و MySQL و MariaDB و PostgreSQL و SQL Server T-SQL و SQLite و Oracle PL/SQL و BigQuery و Snowflake و Redshift و Spark و Trino و DuckDB و ClickHouse و Hive و Db2 و Db2 for i و SingleStore و TiDB و Couchbase N1QL، ولذلك تبقى صياغة كل لهجة سليمة، مثل المعرّفات المحاطة بعلامة ` والأقواس المربعة وتحويل النوع بالرمز :: والسلاسل النصية المحاطة بعلامة الدولار.

أنت تختار الأسلوب المعتمد لديك: الكلمات المفتاحية بأحرف كبيرة أو صغيرة أو كما كُتبت، وكذلك أسماء الدوال وأنواع البيانات؛ مسافتان أو أربع مسافات أو علامات جدولة؛ الفواصل في نهاية السطر أو في بدايته؛ AND و OR قبل فاصل السطر أو بعده؛ وتخطيط قياسي أو جدولي يصفّ الكلمات المفتاحية في عمود واحد. وفي السكربتات المتعددة التعليمات يفصل سطر فارغ بين كل تعليمة وأخرى. أما التصغير فيفعل العكس: يزيل التعليقات والمسافات الزائدة ويبقي السلاسل النصية والأسماء المقتبسة وتلميحات المحسِّن دون تغيير.

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

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

الخصوصية

تُنسَّق تعليمات SQL داخل متصفحك بواسطة Web Worker، ولذلك لا تُرسل إلى أي خادم أبدًا الاستعلامات التي تحتوي على أسماء جداول أو بيانات عملاء أو بيانات اعتماد. تُحفظ اللهجة وخيارات الأسلوب التي تختارها في التخزين المحلي، أما نص SQL نفسه فلا يُخزَّن.

الميزات

20 لهجة SQL

MySQL و PostgreSQL و SQL Server و Oracle و BigQuery و Snowflake و 14 لهجة أخرى.

أسلوبك المعتمد

حالة أحرف الكلمات المفتاحية، والإزاحة، والفواصل في بداية السطر أو نهايته، وموضع AND/OR، والتخطيط الجدولي.

التصغير أيضًا

إزالة التعليقات والمسافات لتضمين SQL في الشيفرة، مع إبقاء السلاسل النصية والتلميحات كما هي.

منسّق SQL: الأسئلة الشائعة

هل يغيّر التنسيق ما يفعله استعلامي؟
لا. يتغير فقط توزيع المسافات وفواصل الأسطر وحالة أحرف الكلمات المفتاحية والدوال وأنواع البيانات؛ أما المعرّفات والسلاسل النصية والتعليقات فتبقى كما هي تمامًا. تغيير حالة أحرف الكلمات المفتاحية آمن لأن SQL لا تفرّق فيها بين الأحرف الكبيرة والصغيرة. وإذا غيّرت حالة أحرف المعرّفات في أدوات أخرى فانتبه إلى أن PostgreSQL تفرّق بين الأحرف الكبيرة والصغيرة في الأسماء المقتبسة، ولهذا يتركها هذا المنسّق دون تغيير.
لماذا يظهر لي خطأ في التحليل؟
يحتاج المنسّق إلى التعرف على بنية التعليمة، ولذلك يوقفه قوس غير مغلق أو كلمة مفتاحية ناقصة أو صياغة تخص قاعدة بيانات أخرى. تذكر الرسالة رقم السطر والعمود وما كان المنسّق يتوقعه هناك. اختر اللهجة التي تستخدمها قاعدة بياناتك: المعرّفات بين أقواس مربعة تتطلب SQL Server، والمحاطة بعلامة ` تتطلب MySQL أو MariaDB أو BigQuery، وتحقق من عدم وجود تعليمات غير مكتملة في النهاية.
هل توضع الفواصل في بداية السطر أم في نهايته؟
وضع الفواصل في نهاية السطر هو الأسلوب الأكثر شيوعًا، وهو ما تنتجه معظم الأدوات. أما وضعها في بداية السطر فيسهّل تحويل العمود الأخير إلى تعليق، ويجعل الفرق بين النسختين سطرًا واحدًا عند إضافة عمود، ولهذا تفضّله بعض فرق البيانات. اختر ما يستخدمه فريقك؛ وهذا الخيار لا يُطبّق إلا على التخطيط القياسي.
هل ينسّق الإجراءات المخزنة والسكربتات التي تضم تعليمات كثيرة؟
نعم. الصق سكربتًا كاملًا فتُنسَّق كل تعليمة ويفصل بينها سطر فارغ، ويشمل ذلك CREATE TABLE و INSERT و UPDATE و MERGE والكتل الإجرائية الشائعة. أما الشيفرة الإجرائية الخاصة بمورّد معيّن، مثل دفعات T-SQL المعقدة التي تفصل بينها GO أو حزم PL/SQL، فقد لا يفهمها المنسّق كاملة؛ اختر اللهجة المطابقة ونسّق كتلًا أصغر إذا تعذّر تنسيق جزء منها.
ما الذي يزيله التصغير؟
يحذف التصغير التعليقات المكتوبة بصيغة -- و /* */ (وتعليقات # في MySQL و MariaDB)، ويحوّل المسافات وفواصل الأسطر المتتالية إلى مسافة واحدة، ويزيل المسافات المجاورة للفواصل والأقواس. أما السلاسل النصية والمعرّفات المقتبسة وتلميحات المحسِّن المكتوبة بصيغة /*+ … */ أو بصيغة MySQL وهي /*! … */ فتبقى كما هي، ولذلك يعمل الاستعلام المصغّر تمامًا مثل الأصلي.