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
;