MySQLでコメントを書く方法｜#・--・/* */の3種類の使い方を解説

MySQLでは、SQL文の中にコメント（注釈）を記述することができます。コメントとして書かれた部分は、MySQLによって実行時に無視されるため、コードの説明やメモ、一時的にSQLを無効化したい場合などに活用できます。

MySQLで使用できるコメントには、主に以下の3種類があります。

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

行頭や文の前に「#」を付けると、その行の「#」以降がすべてコメントとして扱われ、MySQLに無視されます。主に単一行のコメントに使われます。

mysql> create table CommentDemo
    -> (
    -> id int   #Idは整数型です
    -> );
Query OK, 0 rows affected (0.65 sec)

上記の例では、次の部分がコメントとして無視されています。

#Idは整数型です

2. 「--」（ダブルハイフン）を使ったコメント

「--」の後に半角スペースを1つ以上空けてからコメント本文を書くと、その行の残りの部分がコメントになります。こちらも単一行コメント用です。

mysql> create table CommentDemo2
    -> (
    -> id int -- idは整数型です
    -> );
Query OK, 0 rows affected (0.49 sec)

上記の例では、次の部分がコメントとして設定されています。

-- idは整数型です

3. 「/* */」を使ったコメント（複数行コメント）

「/*」と「*/」で囲まれた範囲は、C言語やC++と同じ形式のブロックコメントとして扱われます。この方式の最大の特徴は、複数行にまたがるコメントを記述できる点です。

mysql> create table CommentDemo3
    -> (
    -> /*idは整数型です */
    -> id int
    -> );
Query OK, 0 rows affected (0.52 sec)

上記の例では、次の部分が複数行コメントとして設定されています。

/*idは整数型です */

まとめ

用途に応じてこれらのコメントを使い分けることで、SQLスクリプトの可読性や保守性を高めることができます。特に長いストアドプロシージャやバッチ処理のスクリプトでは、適切なコメントを残しておくことがトラブル防止につながります。