Định dạng SQL

Trước và sau

Trước đó:

SELECT u.id,u.name,COUNT(o.id) AS orders FROM users u LEFT JOIN orders o ON o.user_id=u.id WHERE u.created_at>='2024-01-01' GROUP BY u.id,u.name HAVING COUNT(o.id)>5 ORDER BY orders DESC LIMIT 50;

Sau đó (dấu phẩy chính, các từ khóa viết hoa, lồng dòng 2 khoảng trắng):

SELECT
    u.id
  , u.name
  , COUNT(o.id) AS orders
FROM users u
LEFT JOIN orders o
  ON o.user_id = u.id
WHERE u.created_at >= '2024-01-01'
GROUP BY u.id, u.name
HAVING COUNT(o.id) > 5
ORDER BY orders DESC
LIMIT 50;

Các lựa chọn phong cách quan trọng

• Từ khóa viết hoa so với từ khóa viết thường: Viết hoa là cách truyền thống và dễ được máy đọc hiểu; viết thường lại gọn gàng hơn trong các trình soạn mã hiện đại có chức năng làm nổi bật cú pháp.
• Dấu phẩy đặt đầu và dấu phẩy đặt cuối: Dấu phẩy đặt đầu ( , col) giúp việc ghi chú cho một cột đơn lẻ trở nên dễ dàng hơn; trong khi đó, dấu phẩy đặt cuối (col,) đọc tự nhiên hơn trong văn bản.
• Vị trí dấu phẩy trong GROUP BY: thường dùng một dấu phẩy mỗi dòng cho các mệnh đề dài, viết trên cùng một dòng (inline) cho các mệnh đề ngắn.
• Thụt lề JOIN: đặt ON ở dòng tiếp theo (thụt lề treo) hay trên cùng một dòng. Các điều kiện dài sẽ phù hợp hơn với cách thụt lề treo.
• Các truy vấn con: Nhấn lồng toàn bộ nội dung của truy vấn con, chứ không chỉ phần khung ngoặc mở đầu.

Những vấn đề thường gặp đặc thù cho từng phương ngữ

• Dấu backtick trong MySQL so với dấu nháy kép trong PostgreSQL dùng cho các định danh.
• Các CTE WITH: MS SQL yêu cầu sử dụng ; trước khi sử dụng WITH; bộ định dạng sẽ xử lý điều này.
• Hàm cửa sổ (window functions): các mệnh đề OVER (...) dài sẽ dễ đọc hơn khi PARTITION BY và ORDER BY được ngắt xuống nhiều dòng.
• BigQuery sử dụng các định danh ARRAY_AGG, STRUCT và các hậu tố bảng (*_yyyymmdd), và bộ phân tích ký tự không được phép phá vỡ những định danh này.
• Oracle sử dụng cú pháp nối bên ngoài (+); trình định dạng sẽ giữ nguyên cú pháp này nhưng ghi chú rằng đây là cú pháp cũ.

Những điều mà công cụ định dạng không thực hiện

• Sửa lỗi: Một truy vấn JOIN không hợp lệ sẽ vẫn không thể thực hiện được.
• Mở rộng SELECT *: Danh sách các cột không được suy ra từ sơ đồ dữ liệu.
• Tối ưu hóa truy vấn: chỉ sắp xếp bố cục, không liên quan đến kế hoạch thực thi.
• Viết lại các truy vấn con thành CTE: đây là một vấn đề khác.