블로그로 돌아가기
sql 2025-02-25

읽기 쉬운 쿼리를 위한 SQL 포맷팅 모범 사례

깔끔하고 유지보수 가능한 데이터베이스 쿼리를 작성하기 위한 SQL 포맷팅 규칙, 스타일 가이드, 도구를 배웁니다.

잘 포맷된 SQL은 코드 가독성, 디버깅, 협업에 필수적입니다.

SQL을 포맷해야 하는 이유

  • 가독성: 쿼리 로직을 빠르게 이해
  • 디버깅: 포맷된 쿼리에서 오류를 쉽게 발견
  • 협업: 팀원이 쿼리를 빠르게 리뷰 가능
  • 유지보수: 포맷된 쿼리는 수정하기 쉬움

핵심 포맷팅 규칙

1. 키워드는 대문자로

SELECT name, email

FROM users

WHERE active = true

ORDER BY created_at DESC;

2. 한 줄에 하나의 절

SELECT

u.name,

u.email,

COUNT(o.id) AS order_count

FROM users u

JOIN orders o ON u.id = o.user_id

WHERE u.active = true

GROUP BY u.name, u.email

HAVING COUNT(o.id) > 5

ORDER BY order_count DESC;

3. 일관된 들여쓰기

4칸 스페이스를 사용하세요.

4. 테이블 별칭 사용

SELECT u.name, o.total

FROM users u

JOIN orders o ON u.id = o.user_id;

5. CTE (공통 테이블 표현식)

WITH active_users AS (

SELECT id, name, email

FROM users

WHERE active = true

)

SELECT au.name, au.email

FROM active_users au;

SQL 포매터 도구를 사용하여 SQL 쿼리를 즉시 포맷하세요.