منسق ومتحقق من SQL

لماذا يهم تنسيق SQL

هل سبق لك أن ورثت مشروع قاعدة بيانات حيث يبدو SQL وكأن شخصًا ما كتبه وهو معصوب العينين؟ أنت لست وحدك. التنسيق السيء لـ SQL هو أحد أكثر مصادر الأخطاء وإهدار الوقت في تطوير قواعد البيانات.

يساعدك منسق ومتحقق SQL هذا على تنظيف الاستعلامات تلقائيًا. الصق SQL الخاص بك، وسيطبق على الفور المسافات البادئة الصحيحة، ويرفع الكلمات المفتاحية إلى الحروف الكبيرة، ويتحقق من أخطاء التركيب - كل ذلك في متصفحك دون إرسال بيانات إلى أي خادم. ما يستغرق عادةً 10-15 دقيقة من التنسيق اليدوي يحدث في ثوانٍ.

من خلال تجربتي في العمل مع فرق قواعد البيانات، فإن أكبر موفر للوقت ليس مجرد التنسيق - بل اكتشاف الأخطاء قبل وصولها إلى الإنتاج. يمكن أن يؤدي القوس غير الموضوع أو الاقتباس غير المغلق إلى إهدار ساعات من إصلاح الأخطاء. يكتشف هذا الأداة هذه المشكلات فورًا، قبل تنفيذ أي شيء على قاعدة البيانات الخاصة بك.

كيفية استخدام منسق SQL

واجهة الأداة مصممة بشكل مقصود بسيطة للغاية - فقط انسخ والصق:

الصق كود SQL في مربع الإدخال (أو اكتبه مباشرة إذا كنت تكتب من الصفر)
شاهد التنسيق يتم تلقائيًا أثناء الكتابة - لا توجد أزرار للنقر، ولا إعدادات للتكوين
راجع أخطاء التحقق إن وجدت أسفل المخرجات المنسقة
انسخ كود SQL المنسق بنقرة واحدة للاستخدام في بيئة التطوير، أو التوثيق، أو أداة قاعدة البيانات

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

ما يقوم به منسق SQL

تنسيق الكلمات المفتاحية

يتم تنسيق جميع الكلمات المفتاحية في SQL تلقائيًا بالأحرف الكبيرة—SELECT، FROM، WHERE، JOIN، وهكذا. يتبع هذا الأسلوب الاتفاقية المستخدمة من قبل معظم فرق قواعد البيانات ويجعل الكلمات المفتاحية مميزة بصريًا عن أسماء الجداول والأعمدة الخاصة بك. عند مراجعة استعلام معقد، يساعد هذا الفصل البصري على تحديد هيكل الاستعلام بنظرة واحدة.

المحاذاة الذكية

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

إليك ما يحدث عمليًا: عندما يكون لديك استعلام به عدة عمليات انضمام واستعلامات فرعية، تسمح المحاذاة الصحيحة برؤية هيكل الاستعلام دون قراءة كل كلمة. يمكنك تحديد مكان انتهاء عملية انضمام وبدء أخرى، أو مكان استخدام استعلام فرعي في قائمة SELECT الخاصة بك.

فواصل منطقية

تظهر الفواصل حيث تساعد على سهولة القراءة، وليس في كل مكان. تحصل كل جملة رئيسية على سطرها الخاص. يحصل كل عنصر في القوائم المفصولة بفواصل (مثل أسماء الأعمدة في SELECT) على سطره الخاص مع المحاذاة المناسبة. يتم فصل الاستعلامات الفرعية بصريًا. تنقسم عبارات CASE عند WHEN و THEN و ELSE للوضوح.

يتبع التباعد اتفاقيات دليل أنماط SQL المستخدمة في الصناعة، مما يعني أن SQL المنسق الخاص بك سيبدو مألوفًا للمطورين الآخرين.

التحقق من صحة SQL: ما الذي يتم فحصه

يلتقط المتحقق الأخطاء التي عادة ما تنزلق عندما تكتب SQL بسرعة. لن يحل محل محلل الاستعلامات الخاص بقاعدة البيانات، لكنه يلتقط الأخطاء الشائعة قبل تشغيل الاستعلام.

أخطاء هيكلية

الأقواس غير المتوازنة شائعة بشكل مفاجئ في الاستعلامات المعقدة مع الاستعلامات الفرعية المتداخلة. يقوم المتحقق بعد الأقواس المفتوحة والمغلقة للإشارة إلى عدم التطابق على الفور. لقد رأيت حوادث إنتاج سببها قوس واحد مفقود في استعلام يتكون من 200 سطر - يلتقط هذا الأمر مبكرًا.

حروف السلسلة غير المغلقة تحدث عندما تنسى علامة الاقتباس الختامية على قيمة السلسلة. ستقوم قاعدة البيانات بفحصها على الفور، لكن التقاطها هنا يوفر رحلة ذهاب وإياب.

مشاكل ترتيب الفقرات يتم الإشارة إليها عندما تظهر الفقرات بترتيب غير صحيح. على سبيل المثال، إذا وضعت HAVING قبل GROUP BY، أو WHERE بعد GROUP BY، سيحذرك المتحقق. هذا يتبع قواعد بناء الجملة المعيارية لـ SQL المحددة في المعيار ISO/IEC 9075 للـ SQL.

أخطاء منطقية

فقرات JOIN بدون شروط ON تنشئ عمليات تقاطع عرضية، مما يعيد عددًا أكبر بكثير من الصفوف المقصودة. سيناريو شائع: عند إضافة جدول ثالث أو رابع إلى استعلام وتنسى فقرة ON. بدون هذا الفحص، قد لا تلاحظ حتى ترى آلاف الصفوف المكررة في النتائج.

HAVING بدون GROUP BY غير صالح من الناحية التقنية في معظم قواعد البيانات. تقوم فقرة HAVING بتصفية النتائج المجمعة، لذا تتطلب GROUP BY للعمل. يلتقط المتحقق هذا التعارض المنطقي.

شروط WHERE غير مكتملة تحدث عندما تبدأ في كتابة شرط ولا تنهيه - مثل WHERE status = بدون قيمة. من السهل تفويت هذه الأمور عند تحرير الاستعلامات.

ما لن يلتقطه

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

كانت أسماء الجداول أو الأعمدة موجودة في قاعدة البيانات الخاصة بك
كنت تقوم بالربط على أنواع بيانات متوافقة
سيكون الاستعلام فعالًا أو يحتوي على مشاكل في التحسين
لديك إذن للوصول إلى الجداول التي تستعلمها

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

قواعد التنسيق المطبقة بواسطة هذه الأداة

يطبق المنسق قواعد متسقة بناءً على اتفاقيات دليل أنماط SQL التي تتبعها معظم فرق قواعد البيانات.

الكلمات المفتاحية تكتب بأحرف كبيرة

كل كلمة مفتاحية في SQL تصبح بأحرف كبيرة: SELECT، INSERT، UPDATE، DELETE، CREATE، ALTER، DROP. وهذا يشمل العبارات (FROM، WHERE، GROUP BY، HAVING، ORDER BY)، وأنواع الاتصال (JOIN، INNER JOIN، LEFT JOIN)، والعوامل (AND، OR، NOT، IN، BETWEEN، LIKE)، والدوال الشائعة (COUNT، SUM، AVG، CASE، WHEN).

لماذا بأحرف كبيرة؟ إنها تخلق تمييزًا بصريًا بين عناصر لغة SQL وأسمائك الخاصة بقاعدة البيانات (الجداول، الأعمدة، الأسماء المستعارة). عند مسح الاستعلام، يلتقط عينك على الفور الهيكل.

مسافتان للمستوى الواحد

تبدأ العبارات الرئيسية مثل SELECT و FROM من الهامش الأيسر. تتم إزاحة عبارات JOIN مسافتين تحت FROM لإظهار أنها جزء من اختيار الجدول. يتم إزاحة الاستعلامات الفرعية مسافتين إضافيتين لكل مستوى تداخل. هذا يخلق تسلسلًا هرميًا بصريًا يطابق الهيكل المنطقي.

تحصل قوائم الفواصل (أسماء الأعمدة في SELECT، على سبيل المثال) على سطرها الخاص مع إزاحة متسقة. عندما يكون لديك 15 عمودًا في قائمة SELECT الخاصة بك، يجعل هذا الأمر المسح والعثور على أعمدة محددة سهلًا.

تتراصف الشروط في عبارات WHERE عموديًا. عندما يكون لديك شروط متعددة AND أو OR، يجعل التراصف هيكل المنطق واضحًا على الفور.

قبل وبعد: انظر الفرق

قبل التنسيق:

1select u.id, u.name, o.order_date from users u join orders o on u.id = o.user_id where o.status = "completed" group by u.id order by u.name;
2

بعد التنسيق:

1SELECT
2  u.id,
3  u.name,
4  o.order_date
5FROM users u
6  JOIN orders o ON u.id = o.user_id
7WHERE
8  o.status = "completed"
9GROUP BY
10  u.id
11ORDER BY
12  u.name;
13

قواعد التحقق: ما الذي يتم التعليم عليه

يتحقق المحقق من سلامة البنية والتناسق المنطقي الأساسي. إليك ما يبحث عنه:

الفحوصات الهيكلية

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

السلاسل المغلقة بشكل صحيح: كل علامة اقتباس مفتوحة (مفردة أو مزدوجة) تحتاج إلى علامة اقتباس مغلقة. يبدو الأمر واضحًا، لكن عند كتابة استعلام معقد يحتوي على عدة نصوص حرفية، من السهل إغفال واحدة.

ترتيب الجمل الصحيح: لـ SQL متطلبات ترتيب محددة. SELECT يأتي قبل FROM، الذي يأتي قبل WHERE، الذي يأتي قبل GROUP BY، الذي يأتي قبل HAVING، الذي يأتي قبل ORDER BY. وضعها بترتيب خاطئ يسبب أخطاء في بناء الجملة فورًا. يتحقق المحقق من هذا الترتيب بناءً على معيار SQL.

فحوصات التناسق المنطقي

JOIN مع شرط ON: كل JOIN يحتاج إلى عبارة ON أو USING لتحديد كيفية ارتباط الجداول. بدونها، تحصل على اتصال متقاطع - كل صف من جدول مقترن مع كل صف من جدول آخر. هذا نادرًا ما يكون ما تريده وعادة ما يشير إلى عبارة ON مفقودة.

شروط WHERE كاملة: تحتاج عبارة WHERE إلى مسندات كاملة. WHERE status = بدون قيمة غير مكتملة وغير صالحة. يشير المحقق إلى هذه الشروط الجزئية.

HAVING يتطلب GROUP BY: تصفي عبارة HAVING النتائج المجمعة، لذا فهي ذات معنى فقط عند وجود GROUP BY. استخدام HAVING بدون GROUP BY هو خطأ منطقي ترفضه معظم قواعد البيانات.

قواعد تجميع GROUP BY: عند استخدام دوال التجميع مثل COUNT() أو SUM()، يجب أن تظهر أي أعمدة غير مجمعة في قائمة SELECT في GROUP BY. هذا متطلب أساسي لـ SQL يتحققه المحقق.

مثال على الأخطاء الشائعة التي يتم اكتشافها

إليك SQL بعدة مشكلات سيشير إليها المحقق:

1SELECT user_id, COUNT(*) FROM orders
2JOIN users
3WHERE status =
4GROUP BY
5HAVING count > 10;
6

المشاكل المكتشفة:

JOIN users مفقود شرط ON (سيخلق اتصال متقاطع)
WHERE status = غير مكتمل (لا توجد قيمة مقارنة)
عبارة GROUP BY فارغة (لم يتم تحديد أعمدة)
HAVING count > 10 يشير إلى عمود غير معرف

متى تستخدم منسق SQL هذا

أثناء مراجعات الكود

هل سبق لك محاولة مراجعة استعلام SQL يمتد على 50 سطرًا ومكتوب في سطر واحد؟ الأمر مرهق. قبل تقديم الاستعلامات للمراجعة، قم بتنسيقها باستخدام المنسق. سيشكرك المراجعون، وسيتمكنون بالفعل من التركيز على المنطق بدلاً من فك تشفير البنية.

عند مراجعة طلبات السحب مع تغييرات قاعدة البيانات، اطلب من المساهمين تنسيق SQL الخاص بهم أولاً. يجعل هذا اكتشاف أخطاء المنطق أسهل عندما تكون البنية متسقة.

تصحيح مشاكل الإنتاج

عند معالجة استعلام فاشل في بيئة الإنتاج، يساعد تنسيقه بشكل صحيح على رؤية بنيته بوضوح. لقد قمت بتصحيح العديد من الاستعلامات حيث أصبحت المشكلة واضحة بمجرد تنسيق SQL بشكل صحيح - مثل شرط انضمام مفقود، أو تجميع خاطئ لشرط WHERE، أو استعلام فرعي في المكان الخطأ.

انسخ الاستعلام من السجلات الخاصة بك، والصقه هنا، وستتمكن فورًا من رؤية ما إذا كانت هناك مشاكل هيكلية.

العمل مع SQL المولد

أدوات التعاون بين الكائنات والعلاقات (ORMs) مثل Hibernate، وEntity Framework، أو SQLAlchemy تولد SQL تلقائيًا. في بعض الأحيان تحتاج إلى رؤية الاستعلام الذي يتم إنتاجه بالفعل. عادة ما يكون SQL المولد سطرًا طويلًا بدون تنسيق. يجعل هذه الأداة استعلامات ORM المولدة قابلة للقراءة حتى تتمكن من فهمها وتحسينها.

تعليم وتعلم SQL

إذا كنت تتعلم SQL أو تقوم بتدريسه، يساعدك هذا المنسق على فهم بنية الاستعلام الصحيحة. عندما تلصق استعلامًا يعمل وترى كيف يتم تنسيقه، ستتعلم الاتفاقيات. وعندما تلصق استعلامًا معطوبًا وترى أخطاء التحقق، ستفهم سبب عدم عمله.

الانتقال بين أنظمة قواعد البيانات

تختلف قواعد البيانات المختلفة (PostgreSQL، MySQL، SQL Server) قليلاً في لهجات SQL الخاصة بها. عند نقل الاستعلامات بين الأنظمة، يساعد التنسيق الصحيح على اكتشاف بناء الجملة الخاص بالنظام الذي قد يحتاج إلى تعديل. يتبع المنسق اتفاقيات SQL القياسية التي تعمل عبر معظم قواعد البيانات الرئيسية.

بدائل لمنسق SQL هذا

أدوات تطوير قواعد البيانات المحددة

أدوات مثل DataGrip، وSQL Server Management Studio، أو MySQL Workbench تحتوي على منسقات مدمجة. إنها قوية وتتكامل مباشرة مع اتصالات قاعدة البيانات الخاصة بك.

المقايضة: تتطلب التثبيت والإعداد. يكلف DataGrip 199 دولارًا/سنويًا للأفراد. SSMS مجاني ولكنه خاص بنظام Windows فقط. إذا كنت بحاجة إلى تنسيق سريع دون تثبيت أي شيء، أو كنت تعمل عبر أنظمة قواعد بيانات متعددة، فإن أداة مستندة إلى المتصفح ستكون أكثر عملية.

امتدادات المحرر

إذا كنت تكتب SQL في VS Code أو Sublime Text، فإن الامتدادات مثل SQL Beautify أو SqlBeautifier تجلب التنسيق إلى محررك. هذا يعمل بشكل جيد عندما تكون تكتب الاستعلامات وتريد تنسيقًا فوريًا كجزء من سير عملك.

القيد: تحتاج الامتدادات إلى تكوين، وهي مرتبطة بمحررك المحدد. عند مشاركة SQL مع الزملاء أو نشر الاستعلامات في الوثائق، يضمن منسق ويب موحد أن الجميع يرى نفس التنسيق.

منسقات سطر الأوامر

الأدوات مثل sqlformat (Python) أو sql-formatter-cli (Node.js) يمكن دمجها في أنابيب CI/CD لتنسيق SQL تلقائيًا في التحكم بالإصدار. هذا يفرض الاتساق عبر الفريق.

يُستخدم بشكل أفضل للتدفقات الآلية بدلاً من التنسيق المرتجل. إذا كنت تقوم فقط بتنظيف بعض الاستعلامات أو تتعلم SQL، فإن أدوات سطر الأوامر تضيف تعقيدًا غير ضروري.

كيف أصبح التنسيق SQL ممارسة قياسية

تم تطوير SQL في IBM في السبعينيات، لكن اتفاقيات التنسيق ظهرت في وقت لاحق بكثير. كان SQL المبكر وظيفيًا لكنه غير متسق - حيث كان كل مطور يقوم بتنسيق الاستعلامات بشكل مختلف.

جاء نقطة التحول في التسعينيات عندما انتقلت قواعد البيانات من مشاريع المطور الواحد إلى التطوير الجماعي. بدأت المنظمات في إنشاء أدلة أنماط SQL داخلية للحفاظ على الاتساق. عندما كان لديك خمسة مطورين يعملون على قاعدة بيانات واحدة، أصبح SQL القابل للقراءة ضروريًا للتعاون.

جلبت السنوات 2000 أدوات ORM التي أنتجت SQL تلقائيًا. أنتجت هذه الأدوات SQL عاملًا لكنه قبيح - كل شيء على سطر واحد، بدون مسافات بادئة. هذا خلق الطلب على المنسقين الآليين الذين يمكنهم جعل SQL الذي تم إنشاؤه قابلًا للقراءة للإنسان.

ظهرت منسقات SQL عبر الإنترنت في العقد الأول من القرن الحادي والعشرين مع نضج تطوير الويب. بدلًا من تثبيت الأدوات أو تكوين إضافات IDE، يمكن للمطورين تنسيق SQL في متصفح. هذا جعل الوصول إلى التنسيق المناسب متاحًا للجميع من المبتدئين الذين يتعلمون SQL إلى المطورين ذوي الخبرة الذين ينظفون الاستعلامات السريعة.

اليوم، يُعتبر تنسيق SQL ممارسة أساسية، مشابهة لتنسيق التعليمات البرمجية في لغات البرمجة الأخرى. يوفر دليل أنماط SQL من سايمون هوليويل اتفاقيات واسعة الانتشار، وتنفذ الأدوات مثل هذه المعايير تلقائيًا.

أمثلة على الكود

المثال 1: استعلام SELECT الأساسي

غير منسق:

1select id, first_name, last_name, email from customers where status = 'active' order by last_name, first_name;
2

منسق:

1SELECT
2  id,
3  first_name,
4  last_name,
5  email
6FROM
7  customers
8WHERE
9  status = 'active'
10ORDER BY
11  last_name,
12  first_name;
13

المثال 2: استعلام JOIN

غير منسق:

1select c.id, c.name, o.order_date, o.total_amount from customers c left join orders o on c.id = o.customer_id where o.order_date >= '2023-01-01' and o.status != 'cancelled' order by o.order_date desc;
2

منسق:

1SELECT
2  c.id,
3  c.name,
4  o.order_date,
5  o.total_amount
6FROM
7  customers c
8  LEFT JOIN orders o ON c.id = o.customer_id
9WHERE
10  o.order_date >= '2023-01-01'
11  AND o.status != 'cancelled'
12ORDER BY
13  o.order_date DESC;
14

المثال 3: استعلام معقد مع استعلام فرعي

غير منسق:

1select d.department_name, (select count(*) from employees e where e.department_id = d.id) as employee_count, (select avg(salary) from employees e where e.department_id = d.id) as avg_salary from departments d where d.active = true having employee_count > 0 order by avg_salary desc;
2

منسق:

1SELECT
2  d.department_name,
3  (
4    SELECT
5      COUNT(*)
6    FROM
7      employees e
8    WHERE
9      e.department_id = d.id
10  ) AS employee_count,
11  (
12    SELECT
13      AVG(salary)
14    FROM
15      employees e
16    WHERE
17      e.department_id = d.id
18  ) AS avg_salary
19FROM
20  departments d
21WHERE
22  d.active = TRUE
23HAVING
24  employee_count > 0
25ORDER BY
26  avg_salary DESC;
27

التنسيق البرمجي لـ SQL

إليك أمثلة على كيفية تنفيذ تنسيق SQL في لغات البرمجة المختلفة:

1// مثال على تنسيق SQL في JavaScript باستخدام مكتبة sql-formatter
2const sqlFormatter = require('sql-formatter');
3
4function formatSQL(sql) {
5  return sqlFormatter.format(sql, {
6    language: 'sql',
7    uppercase: true,
8    linesBetweenQueries: 2,
9    indentStyle: 'standard'
10  });
11}
12
13const rawSQL = "select id, name from users where status='active'";
14const formattedSQL = formatSQL(rawSQL);
15console.log(formattedSQL);
16

1# مثال على تنسيق SQL في Python باستخدام sqlparse
2import sqlparse
3
4def format_sql(sql):
5    return sqlparse.format(
6        sql,
7        reindent=True,
8        keyword_case='upper',
9        identifier_case='lower',
10        indent_width=2
11    )
12
13raw_sql = "select id, name from users where status='active'"
14formatted_sql = format_sql(raw_sql)
15print(formatted_sql)
16

1// مثال على تنسيق SQL في Java باستخدام JSqlParser
2import net.sf.jsqlparser.parser.CCJSqlParserUtil;
3import net.sf.jsqlparser.statement.Statement;
4
5public class SQLFormatter {
6    public static String formatSQL(String sql) throws Exception {
7        Statement statement = CCJSqlParserUtil.parse(sql);
8        return statement.toString()
9            .replaceAll("(?i)SELECT", "\nSELECT")
10            .replaceAll("(?i)FROM", "\nFROM")
11            .replaceAll("(?i)WHERE", "\nWHERE")
12            .replaceAll("(?i)ORDER BY", "\nORDER BY");
13    }
14    
15    public static void main(String[] args) throws Exception {
16        String rawSQL = "select id, name from users where status='active'";
17        String formattedSQL = formatSQL(rawSQL);
18        System.out.println(formattedSQL);
19    }
20}
21

1<?php
2// مثال على تنسيق SQL في PHP
3function formatSQL($sql) {
4    // استبدال الكلمات المفتاحية بإصدارات بأحرف كبيرة
5    $keywords = ['SELECT', 'FROM', 'WHERE', 'JOIN', 'LEFT JOIN', 'RIGHT JOIN', 
6                 'INNER JOIN', 'GROUP BY', 'ORDER BY', 'HAVING', 'LIMIT'];
7    
8    $formattedSQL = $sql;
9    foreach ($keywords as $keyword) {
10        $formattedSQL = preg_replace('/\b' . preg_quote($keyword, '/') . '\b/i', "\n$keyword", $formattedSQL);
11    }
12    
13    // إضافة المسافات البادئة
14    $lines = explode("\n", $formattedSQL);
15    $result = '';
16    $indentLevel = 0;
17    
18    foreach ($lines as $line) {
19        $trimmedLine = trim($line);
20        if (!empty($trimmedLine)) {
21            $result .= str_repeat("  ", $indentLevel) . $trimmedLine . "\n";
22        }
23    }
24    
25    return $result;
26}
27
28$rawSQL = "select id, name from users where status='active'";
29$formattedSQL = formatSQL($rawSQL);
30echo $formattedSQL;
31?>
32

الأسئلة الشائعة

هل يعمل منسق SQL هذا مع PostgreSQL وMySQL وSQL Server؟

نعم، يتعامل مع بناء الجملة القياسي الشائع عبر قواعد البيانات الرئيسية—PostgreSQL وMySQL وSQL Server (T-SQL) وOracle وSQLite وMariaDB. يركز المنسق على SQL الأساسي الذي يعمل في كل مكان: SELECT وJOIN وWHERE وGROUP BY وما إلى ذلك.

قد لا يتم تنسيق الميزات الخاصة بقاعدة البيانات بشكل مثالي. على سبيل المثال، بناء الجملة المصفوفي الخاص بـ PostgreSQL أو الدوال الخاصة بـ SQL Server قد لا تحصل على معالجة تنسيق خاصة، لكنها لن تكسر المنسق أيضًا. سيظل الاستعلام أكثر وضوحًا مما كان عليه.

هل يتم إرسال كود SQL الخاص بي إلى خادم؟

لا. كل شيء يحدث في متصفحك. الصق كود SQL الخاص بك، وسيتم تنسيقه محليًا دون أي طلبات شبكية. لن تغادر استعلاماتك جهازك أبدًا.

هذا مهم عند العمل مع مخططات قواعد البيانات الإنتاجية أو المنطق التجاري الخاص. لا يوجد خطر من تسجيل أو تخزين معلومات حساسة على خادم شخص آخر.

هل يمكن للمتحقق اكتشاف كل أخطاء SQL؟

ليس حتى قريبًا. يكتشف المشاكل الهيكلية والنحوية—الأقواس المفقودة، واقتباسات غير مغلقة، والعبارات في الترتيب الخاطئ. هذا كل شيء.

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

لماذا تنسيق SQL عندما تشغله قاعدة البيانات بغض النظر؟

قواعد البيانات لا تهتم بالتنسيق—فهي تحلل الاستعلام بغض النظر. لكن البشر يهتمون. عندما تحتاج إلى تصحيح استعلام فاشل، أو تعديل موجود، أو مراجعة SQL شخص آخر، يحدث التنسيق الصحيح الفرق بين فهمه في 30 ثانية أو 30 دقيقة.

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

هل يمكنني تخصيص المسافة البادئة أو نمط الكلمات المفتاحية؟

ليس في الوقت الحالي. يستخدم المنسق الاتفاقيات القياسية: الكلمات المفتاحية بأحرف كبيرة، مسافة بادئة مكونة من مسافتين، وضع العبارات على سطور منفصلة. هذه تتبع دليل أنماط SQL الذي تستخدمه معظم الفرق.

إذا كنت بحاجة إلى تنسيق مخصص (عرض مسافة بادئة مختلف، كلمات مفتاحية بأحرف صغيرة)، ستحتاج إلى أداة سطر الأوامر قابلة للتكوين مثل sqlformat أو بيئة تطوير متكاملة مع إعدادات التنسيق.

هل سيعمل هذا مع الإجراءات المخزنة بـ 1000 سطر؟

سيقوم بتنسيق الاستعلامات الكبيرة، على الرغم من أن الإجراءات المخزنة المعقدة للغاية (1000+ سطر) قد تستغرق بضع ثوانٍ للمعالجة. يتعامل المنسق مع كود SQL الذي تلصقه، بغض النظر عن الطول.

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

هل يغير التنسيق كيفية تنفيذ الاستعلام؟

لا. التنسيق يضيف مسافات بيضاء ويغير حالة الأحرف فقط. قاعدة البيانات تتجاهل كليهما. الاستعلام المنسق يعيد نفس النتائج ويعمل بنفس الأداء كالإصدار غير المنسق.

الاستثناء الوحيد: إذا وجد المتحقق أخطاء نحوية فعلية (أقواس مفقودة، إلخ)، فإن إصلاحها سيغير السلوك—لكن فقط من "لا يعمل" إلى "يعمل بشكل صحيح".

أي معيار SQL يتبعه؟

يتبع المنسق اتفاقيات SQL-92 مع امتدادات للميزات الشائعة في SQL:1999 والمعايير اللاحقة. هذا يغطي SQL الذي يكتبه معظم المطورين يوميًا—استعلامات SELECT، والاتصالات، والاستعلامات الفرعية، وعبارات CASE، ووظائف النافذة.

الميزات الجديدة جدًا من SQL:2016 أو SQL:2019 قد لا يتم التعرف عليها، لكنها لن تكسر المنسق. ستحصل فقط على تنسيق أساسي بدلاً من المعالجة المتخصصة.

هل يمكنني استخدامه لـ Oracle PL/SQL أو SQL Server T-SQL؟

للاستعلامات الأساسية، نعم. بالنسبة للكود الإجرائي (كتل PL/SQL، الإجراءات المخزنة T-SQL مع تدفق التحكم)، سيكون التنسيق محدودًا. تركز الأداة على عبارات SELECT وINSERT وUPDATE وDELETE وعباراتها.

إذا كنت تعمل بكثافة مع الكود الإجرائي الخاص بقاعدة البيانات، فإن البيئة المتكاملة الأصلية لقاعدة البيانات (SQL Developer لـ Oracle، SSMS لـ SQL Server) ستوفر تنسيقًا أفضل يفهم بناء الجملة الكامل.

المراجع والقراءة الإضافية

دليل أنماط SQL للمؤلف سايمون هوليويل - المعيار الفعلي لاتفاقيات تنسيق SQL المستخدمة من قبل فرق التطوير
المعيار الدولي ISO/IEC 9075 لـ SQL - المواصفات الرسمية للمعيار الدولي لـ SQL
توثيق بناء الجملة SQL الخاص بـ PostgreSQL - المرجع الشامل لبناء الجملة SQL في PostgreSQL
مرجع Microsoft T-SQL - الوثائق الرسمية للهجة T-SQL الخاصة بـ SQL Server
دليل مرجعي MySQL - المرجع الكامل لعبارات SQL في MySQL

ابدأ بتنسيق SQL الخاص بك

يجعل SQL المقروء عملية تصحيح الأخطاء أسرع، ومراجعات الكود أسهل، والتعاون أكثر سلاسة. قم بلصق الاستعلام الخاص بك أعلاه لرؤيته منسقًا وفقًا للمعايير الصناعية المعتادة - لا تحتاج إلى تثبيت، ولا إلى تكوين، ولن تغادر بياناتك المتصفح.

منسق ومتحقق من SQL - تنسيق استعلامات SQL عبر الإنترنت مجانًا

التوثيق

لماذا يهم تنسيق SQL

كيفية استخدام منسق SQL

ما يقوم به منسق SQL

تنسيق الكلمات المفتاحية

المحاذاة الذكية

فواصل منطقية

التحقق من صحة SQL: ما الذي يتم فحصه

أخطاء هيكلية

أخطاء منطقية

ما لن يلتقطه

قواعد التنسيق المطبقة بواسطة هذه الأداة

الكلمات المفتاحية تكتب بأحرف كبيرة

مسافتان للمستوى الواحد

قبل وبعد: انظر الفرق

قواعد التحقق: ما الذي يتم التعليم عليه

الفحوصات الهيكلية

فحوصات التناسق المنطقي

مثال على الأخطاء الشائعة التي يتم اكتشافها

متى تستخدم منسق SQL هذا

أثناء مراجعات الكود

تصحيح مشاكل الإنتاج

العمل مع SQL المولد

تعليم وتعلم SQL

الانتقال بين أنظمة قواعد البيانات

بدائل لمنسق SQL هذا

أدوات تطوير قواعد البيانات المحددة

امتدادات المحرر

منسقات سطر الأوامر

كيف أصبح التنسيق SQL ممارسة قياسية

أمثلة على الكود

المثال 1: استعلام SELECT الأساسي

المثال 2: استعلام JOIN

المثال 3: استعلام معقد مع استعلام فرعي

التنسيق البرمجي لـ SQL

الأسئلة الشائعة

هل يعمل منسق SQL هذا مع PostgreSQL وMySQL وSQL Server؟

هل يتم إرسال كود SQL الخاص بي إلى خادم؟

هل يمكن للمتحقق اكتشاف كل أخطاء SQL؟

لماذا تنسيق SQL عندما تشغله قاعدة البيانات بغض النظر؟

هل يمكنني تخصيص المسافة البادئة أو نمط الكلمات المفتاحية؟

هل سيعمل هذا مع الإجراءات المخزنة بـ 1000 سطر؟

هل يغير التنسيق كيفية تنفيذ الاستعلام؟

أي معيار SQL يتبعه؟

هل يمكنني استخدامه لـ Oracle PL/SQL أو SQL Server T-SQL؟

المراجع والقراءة الإضافية

ابدأ بتنسيق SQL الخاص بك