SQL 스타일 가이드

SQL 스타일 가이드: 가독성과 실수를 줄이는 작성법

SQL은 대소문자를 구분하지 않지만, 명확한 규칙을 따라 작성하면 유지보수와 협업이 쉬워집니다. 아래는 대표적인 SQL 스타일 가이드라인입니다.

1. SQL 키워드는 대문자

설명:
SELECT, FROM, WHERE, JOIN, ORDER BY 등 주요 키워드는 대문자로 작성하여 눈에 잘 띄게 합니다.

예시:

SELECT name, email
FROM users
WHERE age > 60;

2. 테이블명과 칼럼명은 소문자

설명:
사용자 정의 요소는 소문자로 작성하여 키워드와 구분되도록 합니다.

예시:

SELECT title, author
FROM books
WHERE published_year > 2000;

3. 들여쓰기와 줄 나누기 사용

설명:
각 절(SELECT, FROM, WHERE 등)은 줄을 나누어 작성하고, 조인은 들여쓰기로 구조를 드러냅니다.

예시:

SELECT
    u.name,
    u.email,
    o.order_date
FROM
    users u
JOIN
    orders o ON u.id = o.user_id
WHERE
    o.order_date >= '2025-01-01';

4. 별칭은 짧고 명확하게

설명:
테이블이나 서브쿼리에 별칭(alias)을 줄 때는 축약형을 쓰되, 의미를 유지하도록 합니다.

예시:

SELECT p.title, a.name
FROM posts p
JOIN authors a ON p.author_id = a.id;

5. SQL 예약어는 피해서 칼럼명 정하기

설명:
user, order, select 등은 SQL의 예약어이므로, 테이블/칼럼명으로 사용할 경우 에러가 날 수 있습니다.

예시:

잘못된 칼럼명: user

권장되는 방식: user_name, user_id

6. 정렬과 그룹화도 명확하게

예시:

SELECT category, COUNT(*) AS total
FROM products
GROUP BY category
ORDER BY total DESC;

7. 주석으로 문장 설명 추가하기

설명:
복잡한 쿼리에는 주석을 달아 가독성을 높이고, 향후 유지보수에 도움을 줍니다.

예시:

-- 2024년 이후 가입한 사용자 목록 조회
SELECT name, email
FROM users
WHERE signup_date >= '2024-01-01';

마무리

SQL 문은 단순한 코드가 아니라 데이터에 대한 문서입니다.

일관된 스타일을 유지하면 나와 남 모두를 위한 친절한 코드가 됩니다.