SQL Server 註解語法速查：單行與多行註解範例

SQL Server 支援兩種註解風格，適用於說明邏輯、暫時停用程式碼、版本控制標記。

語法速查

實戰範例

單行註解

SELECT Student.sno, sname, AVG(grade) AS avg_g
FROM Student, SC
WHERE Student.sno = SC.sno AND cno <> '008'
GROUP BY Student.sno -- 未加 Student. 會報「列名 'sno' 不明確」
HAVING MIN(grade) >= 60
ORDER BY avg_g DESC;

多行註解

/* 
把對 Student 表和 Course 表的全部權限授予用戶 U2 和 U3
GRANT ALL PRIVILEGES ON TABLE Student, Course TO U2, U3;

把對表 SC 的查詢權限授予所有用戶
GRANT SELECT ON TABLE SC TO PUBLIC;

把查詢 Student 表和修改學生學號的權限授給用戶 U4
GRANT UPDATE(Sno), SELECT ON TABLE Student TO U4;

把用戶 U4 修改學生學號的權限收回
REVOKE UPDATE(Sno) ON TABLE Student FROM U4;
*/

最佳實務

• 複雜邏輯前加單行註解說明用途
• 大區塊暫時停用用多行註解，勿刪除
• 避免多行註解巢狀，易導致提前結束
• 版本控制標記：-- v1.2 2024-01-15 新增 HAVING 條件

良好的註解習慣，讓維護者（包含未來的自己）秒懂意圖。