ใน SQL มีคอมเมนต์ 2 ประเภท ได้แก่ คอมเมนต์บรรทัดเดียว (single-line) และคอมเมนต์หลายบรรทัด (multi-line) บทความนี้จะอธิบายทั้งสองประเภทพร้อมตัวอย่าง และเหตุผลที่ควรใช้คอมเมนต์
เมื่อเราเขียนคอมเมนต์ในโค้ด เรากำลังทำให้เจตนาของโค้ดชัดเจนขึ้น การอธิบายว่าโค้ดทำอะไรจะช่วยให้ผู้พัฒนาคนต่อไปที่ต้องมาอ่านหรือแก้ไขโค้ด เข้าใจง่ายขึ้น ไม่ต้องมาติดต่อสอบถามผู้เขียนเดิม
ใน SQL มี 2 วิธีในการเขียนคอมเมนต์: คอมเมนต์บรรทัดเดียวสำหรับความต้องการสั้นๆ และคอมเมนต์หลายบรรทัดเมื่อต้องการอธิบายยาวหรือปิดบล็อกโค้ดหลายบรรทัด
คอมเมนต์บรรทัดเดียว (Single-line Comment)
ใช้เครื่องหมาย -- (ขีดสองครั้ง) นำหน้าบรรทัดที่ต้องการทำเป็นคอมเมนต์:
CREATE TABLE names ( id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(128) NOT NULL ); INSERT into names VALUES (1, "Christina"); INSERT into names VALUES (2, "Ashleigh"); INSERT into names VALUES (3, "Sarah"); INSERT into names VALUES (4, "Tad"); INSERT into names VALUES (5, "Dustin"); --INSERT into names VALUES (6, "Elissa"); INSERT into names VALUES (7, "Kelly"); SELECT * from names
บรรทัดที่ขึ้นต้นด้วย -- จะไม่ถูกนำไปรัน (ในตัวอย่างบรรทัดที่ 6 ถูกปิดการทำงาน)
คอมเมนต์หลายบรรทัด (Multi-line Comment)
คล้ายกับคอมเมนต์หลายบรรทัดใน JavaScript หรือ CSS ใช้ /* ... */ ครอบบล็อกที่ต้องการ:
CREATE TABLE names ( id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(128) NOT NULL ); INSERT into names VALUES (1, "Christina"); INSERT into names VALUES (2, "Ashleigh"); INSERT into names VALUES (3, "Sarah"); INSERT into names VALUES (4, "Tad"); /*INSERT into names VALUES (5, "Dustin"); INSERT into names VALUES (6, "Elissa")*/ INSERT into names VALUES (7, "Kelly"); SELECT * from names
ในตัวอย่าง บรรทัดที่ 5-6 ถูกปิดการทำงานด้วย /* ... */ ซึ่งเป็นไวยากรณ์เดียวกับหลายภาษาโปรแกรมมิ่ง
หากคุณเข้าใจการใช้คอมเมนต์ใน SQL แล้ว ลองอ่านบทช่วยสอนเพิ่มเติมดังนี้: