SQLのコメントアウト方法：1行コメントと複数行コメントの基本

SQL文には、1行コメントと複数行コメントの2種類のコメントがあります。この記事では、それぞれの具体例を交えながら解説し、なぜコメントを活用すべきなのかについても考えていきます。

コードにコメントを書くことは、開発者が自分の意図をコードを通して明確に伝えるための重要な手段です。コードが何をしているのかを説明しておけば、後からそのコードを編集する開発者も内容を容易に理解でき、わざわざ元の作成者に質問しに行くことなく、プロジェクトをスムーズに前進させることができます。

SQL文では、コメントを記述する方法が2つあります。1行だけコメントを追加したい場合に使う「1行コメント」と、複数行にわたるコメントを追加したい場合に使う「複数行コメント」です。

1行コメントの書き方

1行コメントは、コメントアウトしたい行の先頭にハイフン2つ（--）を付けることで表します。

CREATE TABLE names (
 id INTEGER PRIMARY KEY AUTOINCREMENT,
 name VARCHAR(128) NOT NULL
);
INSERT into names VALUES (1, "Christina");
INSERT into names VALUES (2, "Ashleigh");
INSERT into names VALUES (3, "Sarah");
INSERT into names VALUES (4, "Tad");
INSERT into names VALUES (5, "Dustin");
--INSERT into names VALUES (6, "Elissa");
INSERT into names VALUES (7, "Kelly");
 
SELECT * from names

上記の例では、「Elissa」を挿入する行の先頭に「--」を付けることで、その行だけを実行対象から除外しています。

複数行コメントの書き方

複数行コメントは、JavaScriptやCSSのコメントと同じように、複数行にわたってコメントを記述できる方法です。

CREATE TABLE names (
 id INTEGER PRIMARY KEY AUTOINCREMENT,
 name VARCHAR(128) NOT NULL
);
INSERT into names VALUES (1, "Christina");
INSERT into names VALUES (2, "Ashleigh");
INSERT into names VALUES (3, "Sarah");
INSERT into names VALUES (4, "Tad");
/*INSERT into names VALUES (5, "Dustin"); 
INSERT into names VALUES (6, "Elissa")*/
INSERT into names VALUES (7, "Kelly");
 
SELECT * from names

ここでは、JavaScriptの複数行コメントやCSSのコメントでおなじみの「/* コメント */」という構文を使って、2行をまとめてコメントアウトしています。この構文を使えば、一時的に複数の処理を無効化したり、長めの説明文をコード内に残したりすることができます。

SQLでのコメントの書き方に慣れてきたら、ぜひ次のチュートリアルもチェックしてみてください！

関連リソース：

SQL Create Table（テーブルの作成）

SQL Where（条件の指定）