SQL Style Guide tiếng Việt

Mở đầu

SQL Style Guide này giúp các bạn viết câu lệnh SQL một cách dễ hiểu, dễ đọc hơn.
Các quy tắc viết SQL trong bài này mình tham khảo, tạm dịch từ nguồn https://www.sqlstyle.guide/

Các quy tắc chung

✅ Nên

Sử dụng những định danh và tên có ý nghĩa, dễ hiểu và có tính nhất quán
Sử dụng khoảng trắng và thụt dòng hợp lý để code dễ đọc hơn
Lưu trữ thông tin ngày giờ theo chuẩn format ISO-8601: YYYY-MM-DD HH:MM:SS.SSSSS
Cố gắng chỉ sử dụng những hàm tiêu chuẩn của SQL thay vì những hàm từ vendor khác
Giữ cho code ngắn gọn và không có những SQL thừa thải, chẳng hạn như những dấu ngoặc kép, ngoặc đơn không cần thiết, hoặc câu truy vấn WHERE chồng lên những điều kiện khác.
Thêm comment vào các câu lệnh SQL khi cần thiết để giúp code dễ hiểu hơn. Nếu có thể thì sử dụng cú pháp comment trong ngôn ngữ C /* */, trong các trường hợp khác thì sử dụng cú pháp comment -- và kết thúc bằng việc xuống dòng.

sql

        Copy
      SELECT title  -- title of article
  FROM articles
 WHERE status = 'published';

sql

        Copy
      /* Updating the article status to published */
UPDATE articles
   SET status = 'published',
       updated_at = '2022-12-20 11:23:31.00000'
 WHERE id = 10;

❌ Không nên

CamelCase, bởi vì sẽ khó đọc
Tiếp đầu ngữ dùng để giải thích hoặc ký hiệu Hungary ví dụ như sp_ hoặc tbl
Số nhiều, cố gắng sử dụng từ ngữ mang ý nghĩa của sự tập hợp. Ví dụ nên sử dụng staff thay vì employees, hoặc nên sử dụng people thay vì individuals
Định danh trong dấu ngoặc, trong trường hợp bắt buộc phải sử dụng thì dùng dấu ngoặc kép đôi tiêu chuẩn SQL-92 (tuỳ thuộc vào vendor mà bạn có thể phải cấu hình SQL server để hỗ trợ điều này)
Không nên sử dụng nguyên tắc lập trình hướng đối tượng vào SQL hoặc cấu trúc database.