SQL التعليقات

مفهوم التعليقات

نستخدم التعليقات ( Comments ) لنضع ملاحظات أو شروحات حول الإستعلامات أو الدوال المعقدة الكبيرة التي قمنا بإنشائها حتى لا ننسى سبب كتابتنا للأوامر التي وضعناها بها بذاك الشكل التحديد, و بالتالي في حال أردنا مراجعتها أو التعديل عليها بعد مدة فذلك سيكون سهل جداً لأننا سنقرأ التعليقات حتى نفهم طريقة تركيب الأوامر بسرعة و من ثم نعدل ما نشاء.

وضع تعليقات لا يؤثر إطلاقاً على الأوامر الموضوعة في الإستعلام و يمكن وضع عدد غير محدود من التعليقات.

التعليقات بشكل عام يمكن وضعها في أغلب أنواع قواعد البيانات و لكن ليس في جميعها, فعلى سبيل المثال قواعد بيانات Access لا تسمح بوضع تعليقات.

ملاحظة أخرى و هي أن التعليقات لا توضع بنفس الطريقة في جميع أنواع قواعد البيانات فمثلاً هناك ثلاث خيارات لوضع تعليقات في قواعد بيانات MySQL, أما في قواعد بيانات Oracle فيوجد خيارين فقط.

تذكر: أنت لست مجبراً على وضع تعليقات. و لكننا ننصحك بوضع تعليقات كلما دعت الحاجة.

طرق وضع تعليقات في قواعد بيانات MySQL

هناك ثلاث خيارات لوضع تعليقات في قواعد بيانات MySQL و هي كالتالي:

• إستخدام الرمز -- بعده تضع التعليق لوضع تعليق على سطر واحد.
• إستخدام الرمز # بعده تضع التعليق لوضع تعليق على سطر واحد.
• تضع الرمز /* بعده تضع بينهم */ لوضع تعليق يتألف من عدة أسطر.

الخيار الأول و الخيار الثالث متوفران في أغلب قواعد البيانات التي تسمح بوضع تعليقات.

في المثال التالي إستخدمنا الرمز -- لوضع عدة تعليقات (شروحات) و كل تعليق منها يتألف من سطر واحد.

SELECT * FROM products -- إجلب كل معلومات المنتج
WHERE id = 3;          -- يساوي 3 id الذي يملك رقم

-- بتفصيل ممل لاحقاً SQL ركز على طريقة وضع التعليق و ليس على طريقة عمل الكود لأننا سنشرح لك أوامر
		

في المثال التالي إستخدمنا الرمز /* .. */ لوضع تعليق واحد يتألف من عدة أسطر.

/*
	marks و الجدول students هذا الإستعلام يقوم بجلب معلومات طالب موزعة في الأساس بداخل جدولين هما الجدول
	و إسم و علامات كل طالب معدله أكثر من 80 id فكرة هذا الإستعلام أنه يجلب رقم
  
	بتفصيل ممل لاحقاً SQL ركز على طريقة وضع التعليق و ليس على طريقة عمل الكود لأننا سنشرح لك أوامر
*/
SELECT s.studentid, s.name, s.total_marks
FROM student s, marks m
WHERE s.studentid = m.studentid
AND m.total_marks > 80;