MySQLクエリにコメントを追加する3つの方法とは？書き方と実行例を解説

MySQLサーバーでは、SQLクエリ内にコメント（注釈）を記述するための方法が複数用意されています。コメントを活用することで、クエリの意図や処理内容を説明でき、コードの可読性や保守性が大きく向上します。

ここでは、MySQLで利用できる3種類のコメントの書き方と、それぞれの特徴・実行例を詳しく解説します。

1. 「#」を使ったコメント

「#」から始まる形式は単一行コメントです。「#」以降からその行の末尾までがコメントとして扱われます。手軽に短いメモを残したい場合に便利です。

2. 「--」を使ったコメント

「--」（ハイフン2つ）も単一行コメントです。ただし、「--」の後には必ず半角スペースまたは制御文字が必要です。スペースを入れずに記述すると正しく認識されないので注意しましょう。

3. 「/* */」を使ったコメント

「/*」と「*/」で囲む形式は複数行コメントです。開始と終了の記号が同じ行にある必要がないため、複数行にまたがる長いコメントを記述できます。また、クエリの途中に埋め込む「インラインコメント」としても使用可能です。

3種類のコメントの実行例

以下は、3種類すべてのコメントを使用した実際の実行例です。

mysql> Select NOW() #Single line comment continues to the end of line
    -> ;
+---------------------+
| NOW()               |
+---------------------+
| 2017-11-07 15:04:03 |
+---------------------+
1 row in set (0.00 sec)

mysql> Select NOW() -- Single line comment continues to the end of line
    -> ;
+---------------------+
| NOW()               |
+---------------------+
| 2017-11-07 15:04:17 |
+---------------------+
1 row in set (0.00 sec)

mysql> Select 1 /* in-line comment */ +1;
+-------+
| 1 +1  |
+-------+
|     2 |
+-------+
1 row in set (0.10 sec)

mysql> Select 1
    -> /*
    /*> this is a Multiple-line
    /*> comment
    /*> */
    -> +1;
+-------+
| 1  +1 |
+-------+
|     2 |
+-------+
1 row in set (0.00 sec)

まとめ

• 「#」：単一行コメント。行末までがコメントになる。
• 「-- 」：単一行コメント。後ろにスペースまたは制御文字が必要。
• 「/* */」：複数行コメント。インラインでも複数行でも使える柔軟な形式。

用途に応じてこれらのコメントを使い分けることで、SQLスクリプトの可読性と保守性を高めることができます。