SQLステートメントのコメントは、アプリケーションの読みやすさと保守性を向上させます。コメントは、ステートメント内の任意のキーワード、パラメータ、または句読点の間に記述できます。
例えば、ステートメント内にコメントを追加して、そのステートメントがアプリケーション内でどのように使用されるかを説明できます。Hintを除き、SQLステートメント内のコメントはステートメントの実行に影響しません。
ステートメント内にコメントを追加するには、以下の2つの方法があります：
スラッシュとアスタリスク（/*）で始まるコメント。
スラッシュとアスタリスクの後にコメントのテキストを続けます。このテキストは複数行にわたることができ、アスタリスクとスラッシュ（*/）でコメントを終了します。開始と終了の記号は、テキストとの間にスペースや改行文字を入れる必要はありません。
2つのハイフン（--）で始まるコメント。
記号の後にコメントのテキストを続けます。その前には必ずスペースを入れてください。このテキストは新しい行には拡張できず、改行文字でコメントを終了します。
1つのSQLステートメントには、2種類の異なるスタイルのコメントを同時に含めることができます。コメントのテキストには、データベース文字セットの任意の印刷可能な文字を含めることができます。
以下の例は、スラッシュとアスタリスク（/*）で始まるコメントを示しています。
SELECT last_name, emp_id, salary + NVL(comm_pct, 0),
job_id, e.dept_id
/* 张三より給与の高い従業員を選択します.*/
FROM emp e, dept d
/*DEPTテーブルのデータは部門名です.*/
WHERE e.dept_id = d.dept_id
AND salary + NVL(comm_pct,0) > /* サブクエリは以下のとおりです: */
(SELECT salary + NVL(comm_pct,0)
FROM emp
WHERE last_name = 'Zhangsan')
ORDER BY last_name, emp_id;
以下の例は、2つのハイフン（- -）で始まるコメントを示しています。
SELECT last_name, -- 従業員名を選択します
employee_id -- 従業員ID
salary + NVL(commission_pct, 0), -- 総給与
job_id, -- 職位名
e.department_id -- 部門
FROM employees e, -- 全従業員から選択します
departments d
WHERE e.department_id = d.department_id
AND salary + NVL(commission_pct, 0) >
(SELECT salary + NVL(commission_pct,0)
FROM employees
WHERE last_name = 'Zhangsan')
ORDER BY last_name
employee_id
;