Cách sử dụng tốt nhất hàm bình luận trong MySQL

Nhận xét được sử dụng để thêm thông tin vào mã. Nó hầu như bị trình biên dịch bỏ qua, nhưng các chuyên gia về con người có thể đọc những nhận xét đó khi họ xem mã của bạn. Nhận xét là cần thiết cho các nhà phát triển vì họ có thời gian hạn chế và nhận xét cho phép họ nhận được thông tin có giá trị ngay lập tức hoặc lưu ý một số chi tiết quan trọng liên quan đến mã. Việc truy cập vào dữ liệu này cho phép họ đưa ra quyết định đúng đắn và làm việc nhanh hơn.

Làm thế nào để nhận xét có ích cho tôi?

Nhận xét hữu ích cho cá nhân bạn và cho bất kỳ ai có thể cần đọc hoặc chỉnh sửa mã này sau này. Nhưng chính xác thì như thế nào?

Nhận xét có thể là chỗ dành sẵn khi viết mã. Tại thời điểm đó, bạn có thể giả định điều gì đó và bạn sẽ biết liệu giả định của mình có đúng trong tương lai hay không.

Nhận xét có thể ghi lại suy nghĩ của bạn hoặc là ghi chú cho chính bạn để bạn sẽ không quên những việc làm của mình khi xem lại chúng sau này.

Bạn có thể bao gồm nhận xét về những gì bạn đã làm trong mã của mình để các lập trình viên khác hiểu nó tốt hơn và nhanh hơn (thời gian của lập trình viên là rất, rất tốn kém).

Bạn có thể sử dụng nhận xét để tạm thời tắt hoặc bật các phần có lỗi.

Nhận xét về từng dòng của tập lệnh giúp việc theo dõi vị trí lỗi có thể nằm trong chương trình trở nên đơn giản hơn.

Nhận xét có thể giải thích một số dòng mã nhất định đang làm gì hoặc tại sao bạn chọn một số cách tiếp cận cụ thể để tránh mọi hiểu lầm (ví dụ:khi một số phần của mã dành cho một số phần hoặc mục đích cụ thể mà bạn nên hiểu rõ ràng) ,

Bạn có thể viết toàn bộ một đoạn văn giải thích tất cả các chi tiết về phần mã nếu cần cho người mới hoặc những người từ các dự án khác. Thường cần nhận xét khi viết các truy vấn SQL phức tạp với nhiều mệnh đề như INNER JOIN, GROUP BY, v.v.

Nhận xét cho phép bạn ghi chú về những gì bạn đang làm. Điều này giúp những người khác hiểu cách thức và lý do bạn làm điều gì đó để họ có thể duy trì hoặc sửa đổi khi cần.

SQL có phải là ngôn ngữ tốt cho nhận xét không?

Đúng! Nhận xét thường được sử dụng cùng với các ngôn ngữ như SQL và PHP, nơi chúng ta có thể chèn chúng vào tệp văn bản hoặc tập lệnh bằng cách sử dụng hàm nhận xét * / (ví dụ:/ * Đây là nhận xét của tôi * /). Chúng thường cũng dễ sử dụng ở bất kỳ nơi nào khác.

Làm thế nào để nhận xét trong SQL?

Chức năng bình luận sẽ cho phép bạn viết bất kỳ văn bản nào để thêm bình luận trong SQL. Nó không ảnh hưởng đến kết quả cuối cùng miễn là nó xuất hiện trước hoặc sau một ký tự xác định được lập trình trước.

Để thêm nhận xét trong SQL, bạn có thể sử dụng các ký hiệu sau: / * * / hoặc # hoặc - (dấu gạch ngang).

/ * * / sẽ hoạt động cho bất kỳ tình huống nào mà bạn muốn bắt đầu và kết thúc nhận xét của mình tại thời điểm đó mà không cần sử dụng bất kỳ điều gì khác (như dấu ngoặc kép).

# được sử dụng cho một dòng mã tại một thời điểm

- cũng áp dụng cho một dòng mã tại một thời điểm. Đừng quên đặt dấu cách sau dấu gạch ngang kép này.

Trong mã của bạn, nó sẽ như sau:

-- this is a comment

# this is also a comment

/*
   multiline
   comment
*/

Dưới đây là sự khác biệt giữa nhận xét một dòng và nhiều dòng:

mysql> SELECT 1+1;     # This comment continues to the end of line
mysql> SELECT 1+1;     -- This comment continues to the end of line
mysql> SELECT 1 /* this is an in-line comment */ + 1;
mysql> SELECT 1+
/*
this is a
multiple-line comment
*/
1;

Dưới đây là một ví dụ khác về nhận xét nhiều dòng:

SELECT contact_id, last_name, first_name
/*
 * Author: TechOnTheNet.com
 * Purpose: To show a comment that spans multiple lines in your SQL
 * statement in MySQL.
 */
FROM contacts;

Nhận xét bằng ký hiệu #

Bình luận băm cơ bản kiểu có thể được chèn vào văn bản như thế này:

Select * from users ; # this will list users

Nhận xét bằng Dấu gạch ngang (-)

Điều này ít nhiều giống nhau (đừng quên khoảng trắng). SQL chuẩn không thực sự yêu cầu bạn sử dụng không gian ở đó, nhưng MySQL sử dụng nó để tránh các vấn đề với các lệnh như SELECT 10–1.

Select * from users ; -- this will list users

Nhận xét Sử dụng các ký hiệu / * và * /

Nhận xét nhiều dòng này, không giống như hai ví dụ trước, không phải dừng lại ở cuối dòng.

Select * from users ; /* this will list users */

Nhận xét có thể thực thi

Theo quy định, bất kỳ ai ở đầu bên kia đều bỏ qua nhận xét (vì chúng chỉ dành cho lập trình viên), nhưng một số loại nhận xét - nhận xét có thể thực thi - cho phép mã chạy trên một số hệ thống.

Trong trường hợp của chúng tôi, các nhận xét thực thi cho phép bạn sử dụng mã SQL sẽ chỉ được thực thi trong MYSQL, không phải trong các cơ sở dữ liệu khác.

Các nhận xét có thể thực thi phải được chứa trong dấu gạch chéo có dấu hoa thị , như với mã thông thường:

/ *! Mã dành riêng cho MySQL * /

Tuy nhiên, những nhận xét thực thi này yêu cầu cú pháp cụ thể như sau:

/ *! ##### Mã dành riêng cho MySQL * /

Bạn cần ! ##### phần để báo hiệu các bình luận có thể thực thi. Nó đại diện cho phiên bản MYSQL tối thiểu có thể thực thi các bình luận.

Thay vì băm đầu tiên, hãy thay thế phiên bản chính của MYSQL. Thay vì phiên bản thứ hai, phiên bản trẻ hơn và các phiên bản của bản vá được thay thế cho phiên bản cuối cùng.

Chỉ MySQL 5.1.10 hoặc phiên bản mới hơn có thể chạy các nhận xét sau:

CREATE TABLE t1 (
k INT AUTO_INCREMENT,
KEY (k)
) /*!50110 KEY_BLOCK_SIZE=1024; */

Kết luận

Nhận xét làm cho chương trình dễ đọc hơn bằng cách thêm nhiều chi tiết hơn. Bạn có thể nghĩ về chúng tương tự như băm - chúng giảm thời gian cần thiết để hiểu mã hoặc xác định một số phần của nó một cách đáng kể bằng cách cung cấp các đoạn trích nắm bắt bản chất của văn bản. Nếu bạn đã từng làm việc với các bằng chứng không có kiến thức hoặc cố gắng đăng nhập vào Facebook thông qua Google, bạn sẽ biết ý của chúng tôi.

Đó là lý do tại sao việc nhận xét về mã của bạn và biết cách thực hiện chính xác là điều cần thiết. Giữ mã của bạn chính xác với các ghi chú thông tin giúp cuộc sống của tất cả các chuyên gia liên quan trở nên dễ dàng hơn.