SQL 주석 완벽 가이드: 한 줄 주석과 여러 줄 주석 활용법

SQL에는 두 가지 종류의 주석이 있습니다. 바로 한 줄 주석(single-line comment)과 여러 줄 주석(multi-line comment)입니다. 이 글에서는 각 주석 방식을 실제 예시와 함께 자세히 살펴보고, 개발 과정에서 주석을 활용해야 하는 이유까지 함께 알아보겠습니다.

코드에 주석을 다는 이유

개발자가 코드에 주석을 작성한다는 것은 코드를 통해 자신의 의도를 명확히 전달하는 행위입니다. 코드가 어떤 작업을 수행하는지 미리 설명해 두면, 나중에 해당 코드를 수정하게 될 다른 개발자가 내용을 쉽게 파악하고 프로젝트를 이어갈 수 있습니다. 굳이 원래 코드를 작성한 사람을 찾아가 "이 코드가 도대체 무슨 역할을 하나요?"라고 물어볼 필요가 없어지는 것이죠.

SQL 문에서 주석을 작성하는 방법은 크게 두 가지입니다. 한 줄만 주석 처리할 때 사용하는 한 줄 주석과, 두 줄 이상을 주석 처리할 때 사용하는 여러 줄 주석입니다.

SQL 한 줄 주석(Single-Line Comment)

한 줄 주석은 주석으로 처리하고 싶은 줄 맨 앞에 하이픈 두 개(--)를 붙여 표현합니다.

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 (6, "Elissa");
INSERT into names VALUES (7, "Kelly");
 
SELECT * from names

위 예시에서 --INSERT into names VALUES (6, "Elissa"); 구문은 주석 처리되어 실행되지 않습니다. 이처럼 한 줄 주석은 특정 쿼리를 임시로 비활성화하거나 간단한 메모를 남길 때 매우 유용합니다.

SQL 여러 줄 주석(Multi-Line Comment)

여러 줄 주석은 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에서 익숙하게 보던 /* */ 구문을 사용해 두 줄의 INSERT 문을 한 번에 주석 처리했습니다. 여러 줄 주석은 코드 블록 전체를 임시로 제외하거나, 함수·쿼리에 대한 상세한 설명을 덧붙일 때 특히 유용합니다.

마무리

SQL 주석 작성 방법에 익숙해지셨다면, 아래의 관련 튜토리얼도 함께 확인해 보세요. 주석 습관 하나만 잘 들여도 코드 가독성과 팀 협업 효율이 눈에 띄게 좋아집니다.

추가 학습 자료

SQL Create Table(테이블 생성)
SQL Where(조건절 활용)