在Oracle SQL中，注释是用于解释代码逻辑、提高可读性的文本，不会被数据库执行。Oracle支持两种类型的注释语法：
1. 单行注释（--）
使用双连字符--在一行中添加注释，从--开始到行末的所有内容都会被视为注释。
示例：
-- 查询所有员工信息
SELECT * FROM employees;
SELECT employee_id, first_name, last_name -- 选择基本员工信息
FROM employees
WHERE department_id = 10; -- 筛选销售部门员工
2. 多行注释（/* */）
使用/*开始，*/结束，可以跨越多行的注释块。
示例：
/*
该查询用于统计各部门的员工人数
统计结果按部门人数降序排列
*/
SELECT department_id, COUNT(*) AS total_employees
FROM employees
GROUP BY department_id
ORDER BY total_employees DESC;
SELECT /*+ INDEX(emp_idx) */ * -- 提示优化器使用索引
FROM employees
WHERE salary > 5000;
3. SQL提示注释（Hint）
Oracle特有的注释语法，用于向查询优化器提供执行计划建议，格式为/*+ 提示内容 */。
示例：
SELECT /*+ FULL(employees) */ * -- 强制全表扫描
FROM employees
WHERE hire_date > TO_DATE('2023-01-01', 'YYYY-MM-DD');
SELECT /*+ USE_NL(d e) */ * -- 使用嵌套循环连接
FROM departments d
JOIN employees e ON d.department_id = e.department_id;
4. 注释在DDL语句中的应用
注释也可用于临时禁用部分SQL代码：
CREATE TABLE customers (
customer_id NUMBER PRIMARY KEY,
name VARCHAR2(100),
-- email VARCHAR2(100), -- 暂时不需要邮箱字段
phone VARCHAR2(20)
);
5. 注释规范建议
- 函数/过程注释：在代码前使用多行注释说明功能、参数和返回值。
/*
函数名：calculate_tax
功能：根据收入计算税额
参数：income - 税前收入
返回值：税额
*/
CREATE OR REPLACE FUNCTION calculate_tax(income NUMBER)
RETURN NUMBER IS
BEGIN
RETURN income * 0.2; -- 简化示例：20%税率
END;
- 复杂查询注释：在关键逻辑处添加单行注释。
SELECT
e.employee_id,
e.first_name || ' ' || e.last_name AS full_name,
d.department_name,
CASE
WHEN e.salary > 10000 THEN '高薪'
ELSE '普通'
END AS salary_level -- 根据薪资划分等级
FROM employees e
JOIN departments d ON e.department_id = d.department_id
WHERE e.hire_date >= ADD_MONTHS(SYSDATE, -12); -- 筛选近一年入职员工
6. 注释与性能
- SQL提示注释（Hint）可能影响执行计划，需谨慎使用。
- 普通注释不会影响SQL执行效率，但过量注释会增加代码长度。
合理使用注释可以显著提高代码的可读性和可维护性，尤其在复杂业务逻辑或团队协作开发中更为重要。