SQL में Comments

SQL में Comments क्या हैं?

एक SQL query सही result दे सकती है, फिर भी कुछ महीनों बाद उसका कारण समझना कठिन हो सकता है। Developer को यह याद रह सकता है कि query क्या करती है, लेकिन यह भूल सकता है कि कोई विशेष condition क्यों लगाई गई थी। SQL comment इसी समस्या का समाधान है। यह मनुष्य के लिए explanation सुरक्षित रखता है, जबकि सामान्य execution के समय database इसे अनदेखा करता है।

अच्छा comment query का उद्देश्य, business rule या किसी असामान्य निर्णय का कारण बताता है। उदाहरण के लिए, -- परीक्षा से पहले विद्यालय छोड़ चुके विद्यार्थियों को हटाएँ उपयोगी है, क्योंकि इससे filter लगाने का कारण स्पष्ट होता है। केवल -- rows चुनें लिखना कोई विशेष जानकारी नहीं देता।

Comments का उपयोग database scripts को समझाने, testing के समय किसी statement को अस्थायी रूप से रोकने, बड़े script को भागों में बाँटने और UPDATE या DELETE query से पहले सावधानी लिखने के लिए किया जाता है।

MySQL में Comments लिखने के तीन तरीके

MySQL तीन उपयोगी comment forms स्वीकार करता है। पहले दो वर्तमान पंक्ति के अंत तक चलते हैं; तीसरा एक पंक्ति के छोटे भाग या अनेक पंक्तियों को comment बना सकता है।

1. दो hyphen: --

-- केवल active students दिखाएँ
SELECT roll_no, name
FROM students
WHERE status = 'Active';

MySQL का महत्त्वपूर्ण नियम: दोनों hyphen के बाद whitespace दें। -- explanation सही है, जबकि --explanation सुरक्षित नहीं है। यह नियम credit--1 जैसे arithmetic expression को गलती से comment मानने से रोकता है।

2. Hash sign: #

# कक्षा XII की मासिक शुल्क रिपोर्ट
SELECT student_id, amount
FROM fee_payments
WHERE payment_month = 'August';

Hash form MySQL में सुविधाजनक है, लेकिन यह standard SQL का भाग नहीं है। यदि script को भविष्य में PostgreSQL, SQL Server, Oracle या किसी अन्य database में चलाना हो, तो -- का प्रयोग बेहतर है।

3. Block comment: /* ... */

/* वार्षिक परीक्षा परिणाम रिपोर्ट
   कक्षा IX से XII के लिए तैयार
   14 August 2026 को जाँच की गई */
SELECT class_name, AVG(percentage) AS class_average
FROM results
GROUP BY class_name;

Block comment /* से आरंभ और */ पर समाप्त होता है। यह file header, विस्तृत explanation या छोटे inline note के लिए उपयुक्त है। एक block comment के भीतर दूसरा block comment न लिखें; पहला closing marker comment को अपेक्षा से पहले समाप्त कर सकता है।

उदाहरण और वास्तविक परिणाम

नीचे एक छोटी school table प्रयोग की गई है, ताकि प्रत्येक query को चलाकर उसका result जाँचा जा सके।

CREATE TABLE students (
    roll_no INT PRIMARY KEY,
    name VARCHAR(50),
    class_name VARCHAR(10),
    status VARCHAR(10)
);

INSERT INTO students VALUES
(1, 'Aarav', 'X-A', 'Active'),
(2, 'Meera', 'X-A', 'Active'),
(3, 'Kabir', 'X-B', 'Inactive');

उदाहरण 1: अलग पंक्ति में comment

-- केवल विद्यालय में पढ़ रहे विद्यार्थी report में आएँ
SELECT roll_no, name
FROM students
WHERE status = 'Active'
ORDER BY roll_no;

-- से आरंभ होने वाला वाक्य database अनदेखा कर देता है। Kabir को result से comment नहीं, बल्कि WHERE condition हटाती है।

उदाहरण 2: Inline block comment

SELECT name, /* ID card पर दिखाया जाएगा */ class_name
FROM students
WHERE roll_no = 2;

/* ... */ SQL tokens के बीच आ सकता है। इसलिए यह बाकी statement को रोके बिना किसी एक column का उद्देश्य स्पष्ट करता है।

उदाहरण 3: एक condition को अस्थायी रूप से रोकना

SELECT roll_no, name, class_name
FROM students
WHERE status = 'Active'
/* AND class_name = 'X-A' */
ORDER BY roll_no;

यहाँ class filter अस्थायी रूप से अनदेखा होता है, जबकि active-status filter चलता रहता है। Debugging में यह उपयोगी है, पर production release से पहले पुराने commented-out code को हटा देना चाहिए।

Comment Syntax की तुलना

व्यावहारिक उपयोग और अच्छी आदतें

• कारण समझाएँ: कोई filter, join या calculation क्यों आवश्यक है, यह लिखें—विशेषकर जब कारण तुरंत स्पष्ट न हो।
• मान्यताएँ लिखें: बताएँ कि marks में absent विद्यार्थी शामिल हैं या नहीं, fee में late charge जुड़ा है या dates किस time zone में हैं।
• Safe execution बताएँ: data बदलने से पहले matching SELECT चलाकर target rows जाँचने का note लिखें।
• लंबे script को बाँटें: -- 1. Tables बनाएँ और -- 2. Master data डालें जैसे स्पष्ट headings navigation आसान बनाते हैं।
• Comments updated रखें: पुराना और गलत comment, बिना comment से अधिक हानिकारक हो सकता है।
• Secrets न लिखें: password, API key और विद्यार्थियों का निजी data comments में न रखें; script share या Git में commit हो सकता है।

Data बदलने वाली query लिखते समय Safe UPDATE and DELETE Practices में दिए safeguards भी अपनाएँ।

MySQL Comments में सामान्य गलतियाँ

• -- के बाद whitespace न देना: --wrong MySQL comment आरंभ नहीं कर सकता। -- सही explanation लिखें।
• Line comment को अगली पंक्ति तक मान लेना: -- और # newline पर समाप्त हो जाते हैं। हर पंक्ति पर marker लगाएँ या block comment प्रयोग करें।
• */ भूल जाना: अधूरा block comment बाकी script को छिपा सकता है या syntax error दे सकता है।
• Block comments को nest करना: MySQL मनचाहे nested /* ... */ comments को सुरक्षित रूप से support नहीं करता।
• Portable SQL में # लिखना: दूसरा DBMS file को reject कर सकता है। Standard double-hyphen form चुनें।
• Code को ही दोहराना: प्रत्येक SQL keyword का अर्थ लिखने के स्थान पर rule, decision या risk समझाएँ।

अभ्यास प्रश्न

1. Report से inactive students हटाने का कारण बताते हुए single-line comment लिखें।
2. AND city = 'Khurja' को delete किए बिना अस्थायी रूप से रोकें।
3. समझाएँ कि --comment MySQL में असुरक्षित, पर -- comment सही क्यों है।
4. अलग-अलग database systems में चलने वाले script के लिए कौन-सा comment form चुनेंगे और क्यों?

त्वरित सारांश

• SQL comments query को समझाते हैं और सामान्य execution में अनदेखे किए जाते हैं।
• -- portable single-line syntax है; MySQL में hyphens के बाद whitespace अवश्य दें।
• # MySQL का विशेष single-line comment है।
• /* ... */ inline या multi-line block comment बनाता है।
• उपयोगी comments उद्देश्य, नियम और खतरे समझाते हैं; वे स्पष्ट SQL को दोहराते नहीं हैं।
• Comments को सही और updated रखें; उनमें password या sensitive data कभी न लिखें।

Official संदर्भ

• Comments — MySQL 8.4 Reference Manual
• Comments में optimizer hints — MySQL 8.4 Reference Manual
• MySQL 8.4 Reference Manual

References 14 August 2026 को review किए गए। Queries, outputs और explanations original teaching material हैं।