コメントの書き方

このレッスンでは、SQLにおけるコメントの書き方を学び、あとから読み返しても分かりやすいクエリを書けるようになることを目標にします。「SQL コメントアウト 書き方」で調べている方向けです。

コメントは、SQL文の動作には影響しない「人間向けのメモ書き」です。--から行末までが1行コメント、/* */で囲むと複数行コメントになります。

サンプルコードでは、-- studentsテーブルを作成するという1行コメントと、複数行にわたる/* */コメントを使い分けています。実行結果にはこれらのコメントは一切影響せず、あくまで人間が読むための説明として機能している点を確認してみましょう。

初心者がよくつまずくのが、コメントの記号を間違えることです。プログラミング言語によって//や#を使う場合もあるため、SQLでは--を使う、という違いを覚えておく必要があります。他の言語の経験がある方は特に混同しやすいポイントです。

複雑なクエリほど「なぜこの条件をつけたのか」を書き残しておくと、後で自分や他の人が見返したときに理解しやすくなります。一時的にクエリの一部を無効化したいとき(コメントアウト)にもよく使われる、実務でも欠かせない習慣です。