Chú thích trong SQL: Chú thích một dòng và nhiều dòng

Trong SQL có hai loại chú thích: chú thích một dòng (single-line) và chú thích nhiều dòng (multi-line). Bài viết này sẽ trình bày từng loại kèm ví dụ và giải thích tại sao nên sử dụng chú thích.

Khi chúng ta thêm chú thích vào mã nguồn, mục đích là làm rõ ý图 của đoạn mã đó. Việc ghi chú giúp lập trình viên khác (hoặc chính bạn sau này) dễ dàng đọc hiểu và tiếp tục phát triển dự án mà không phải đi hỏi tác giả gốc.

Trong SQL, có hai cách viết chú thích:

Chú thích một dòng: dùng khi chỉ cần chú thích một dòng.
Chú thích nhiều dòng: dùng khi cần chú thích nhiều dòng liên tiếp.

Chú thích một dòng (Single-line Comment)

Chú thích một dòng được bắt đầu bằng hai dấu gạch ngang (--) ở đầu dòng cần chú thích:

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');  -- Dòng này bị bỏ qua
INSERT INTO names VALUES (7, 'Kelly');
SELECT * FROM names;

Chú thích nhiều dòng (Multi-line Comment)

Chú thích nhiều dòng tương tự như chú thích nhiều dòng trong JavaScript hoặc CSS, bao gồm nhiều dòng văn bản:

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;

Ở ví dụ trên, hai dòng INSERT bị chú thích bằng cú pháp /* ... */ quen thuộc.

Kết luận

Việc sử dụng chú thích làm cho mã SQL dễ đọc, dễ bảo trì và giảm thiểu lỗi khi làm việc nhóm. Nếu bạn đã nắm vững cách viết chú thích, hãy tham khảo thêm các hướng dẫn sau:

SQL Create Table
SQL Where