SQL - Comments: A Friendly Guide for Beginners

Xin chào các bạn đam mê SQL! Tôi rất vui mừng được làm hướng dẫn viên của bạn trong hành trình thú vị vào thế giới của các nhận xét SQL. Là người đã dạy khoa học máy tính trong nhiều năm, tôi có thể告诉 bạn rằng việc hiểu các nhận xét giống như việc học nghệ thuật để để lại những ghi chú hữu ích trong mã của bạn. Vậy, chúng ta cùng vào sâu và làm cho điều này trở nên thú vị!

SQL - Comments

What Are SQL Comments? (SQL Comments là gì?)

Trước khi chúng ta nhảy vào chi tiết, hãy nói về SQL comments là gì và tại sao chúng lại quan trọng. Hãy tưởng tượng bạn đang viết một cuốn sách công thức nấu ăn. Liệu có hữu ích nếu bạn thêm những ghi chú nhỏ về lý do bạn chọn một số nguyên liệu hoặc kỹ thuật nhất định? Đó chính xác là điều mà các nhận xét làm trong SQL!

Các nhận xét là những đoạn văn bản trong mã SQL của bạn mà engine cơ sở dữ liệu sẽ bỏ qua. Chúng hoạt động như những ghi chú cho bạn hoặc các lập trình viên khác, giải thích mã của bạn làm gì hoặc tại sao bạn viết nó theo một cách nhất định. tin tôi đi, phiên bản tương lai của bạn sẽ cảm ơn bạn vì đã để lại những manh mối này!

Types of SQL Comments (Các loại nhận xét SQL)

Trong SQL, chúng ta có hai loại nhận xét chính:

Đơn dòng nhận xét
Nhận xét đa dòng

Hãy cùng khám phá chi tiết từng loại này nhé?

Single-Line Comments (Đơn dòng nhận xét)

Đơn dòng nhận xét rất phù hợp cho những giải thích nhanh hoặc ghi chú ngắn. Chúng bắt đầu bằng hai gạch ngang (--) và tiếp tục cho đến cuối dòng. Dưới đây là cách chúng trông như thế nào:

-- This is a single-line comment
SELECT * FROM Customers; -- This selects all customers

Trong ví dụ này, chúng ta có hai đơn dòng nhận xét. Đơn dòng đầu tiên nằm trên một dòng riêng, trong khi đơn dòng thứ hai nằm ở cuối một câu lệnh SQL. Cả hai đều hợp lệ!

Hãy nhìn vào một ví dụ thực tế hơn:

-- Retrieve all orders placed in the last 30 days
SELECT OrderID, CustomerName, OrderDate
FROM Orders
WHERE OrderDate >= DATE_SUB(CURDATE(), INTERVAL 30 DAY);

Ở đây, nhận xét giải thích điều gì mà truy vấn làm, giúp bất kỳ ai đọc mã dễ dàng hiểu mục đích của nó nhanh chóng.

Multi-Line Comments (Nhận xét đa dòng)

Vậy, nếu bạn cần viết một giải thích dài hơn? Đó là khi nhận xét đa dòng rất hữu ích! Các nhận xét này bắt đầu bằng / và kết thúc bằng /. Mọi thứ giữa các ký tự này đều được coi là nhận xét, ngay cả khi nó跨越 nhiều dòng.

Dưới đây là một ví dụ:

/* This query joins the Customers and Orders tables
to find customers who have placed orders in the last month.
It's used for our monthly customer engagement report. */
SELECT DISTINCT C.CustomerName, C.Email
FROM Customers C
JOIN Orders O ON C.CustomerID = O.CustomerID
WHERE O.OrderDate >= DATE_SUB(CURDATE(), INTERVAL 1 MONTH);

Đó có phải là tuyệt vời không? Bạn có thể viết bao nhiêu tùy bạn mà không cần lo lắng về việc thêm -- vào mỗi dòng.

Best Practices for Using SQL Comments (Những thực hành tốt nhất khi sử dụng nhận xét SQL)

Bây giờ bạn đã biết cách viết nhận xét, hãy nói về khi và cách sử dụng chúng hiệu quả. Dưới đây là một số lời khuyên tôi đã thu thập được trong nhiều năm dạy học:

Be Clear and Concise: Viết nhận xét có giá trị. Tránh nói những điều显而易见.
Use Comments to Explain Why, Not What: Mã itself cho thấy điều gì đang được thực hiện. Sử dụng nhận xét để giải thích tại sao nó được thực hiện theo cách đó.
Keep Comments Updated: Nếu bạn thay đổi mã của mình, hãy chắc chắn cập nhật các nhận xét có liên quan!
Use Comments for Complex Queries: Nếu một truy vấn đặc biệt phức tạp, hãy chia nhỏ nó bằng nhận xét giải thích từng phần.
Comment Out Code for Testing: Bạn có thể sử dụng nhận xét để tạm thời vô hiệu hóa một phần mã SQL của bạn cho mục đích kiểm tra.

Hãy xem một ví dụ tích hợp một số thực hành này:

/* Customer Segmentation Query
Purpose: Segment customers based on their total order value
Last Updated: 2023-05-15 */

SELECT
C.CustomerID,
C.CustomerName,
SUM(O.TotalAmount) AS TotalSpent,
CASE
WHEN SUM(O.TotalAmount) > 10000 THEN 'High Value'
WHEN SUM(O.TotalAmount) > 5000 THEN 'Medium Value'
ELSE 'Low Value'
END AS CustomerSegment
FROM
Customers C
JOIN
Orders O ON C.CustomerID = O.CustomerID
-- GROUP BY C.CustomerID, C.CustomerName
GROUP BY 1, 2  -- Using column positions for grouping
HAVING
TotalSpent > 0;  -- Exclude customers with no orders

Trong ví dụ này, chúng ta đã sử dụng một nhận xét đa dòng ở đầu để giải thích mục đích của truy vấn và khi nó được cập nhật lần cuối. Chúng ta cũng đã sử dụng một đơn dòng nhận xét để hiển thị một cách thay thế để viết clause GROUP BY, và một đơn dòng khác để giải thích tại sao chúng ta sử dụng clause HAVING.

Conclusion (Kết luận)

Và thế là bạn đã có nó, các bạn! Bạn vừa học được nghệ thuật của việc nhận xét SQL. Nhớ rằng, những nhận xét tốt giống như phép lịch sự - chúng làm cho mọi thứ mượt mà và愉快 hơn cho tất cả mọi người tham gia. Dù bạn đang viết một ghi chú nhanh bằng đơn dòng nhận xét hay cung cấp một giải thích chi tiết bằng nhận xét đa dòng, bạn đang làm cho mã SQL của bạn dễ đọc và dễ bảo trì hơn.

Khi bạn tiếp tục hành trình SQL của mình, hãy tạo thói quen nhận xét mã của bạn. Đồng nghiệp của bạn (và phiên bản tương lai của bạn) sẽ đánh giá cao điều đó. Chúc các bạn vui vẻ khi lập mã, và mong rằng các truy vấn của bạn luôn chạy mượt mà!

Credits: Image by storyset