SQL 포맷터

🗃️ SQL 포맷터란?

복잡한 SQL 쿼리를 키워드 기준으로 자동 정렬합니다. SELECT, FROM, WHERE, JOIN 등 주요 키워드별로 줄바꿈과 들여쓰기를 적용해 구조를 명확히 보여줍니다.코드 리뷰, 쿼리 최적화, 문서화, 팀 협업 시 일관된 스타일 유지에 필수.MySQL/PostgreSQL/Oracle/SQL Server 등 표준 SQL을 지원합니다.

🔧 포맷팅 옵션

📄 포맷팅 전후 비교

ORM이 생성했거나 로그에서 긁어온 쿼리는 대부분 한 줄로 붙어 있습니다. 아래는 주문 테이블에서 최근 30일 결제 완료 건을 집계하는 실제 형태의 쿼리를 정렬한 예시입니다.

select o.id, u.name, sum(oi.price*oi.qty) total from orders o inner join users u on u.id=o.user_id left join order_items oi on oi.order_id=o.id where o.status='PAID' and o.created_at >= now() - interval 30 day group by o.id, u.name having total > 10000 order by total desc limit 50

SELECT
    o.id,
    u.name,
    SUM(oi.price * oi.qty) total
FROM orders o
INNER JOIN users u
    ON u.id = o.user_id
LEFT JOIN order_items oi
    ON oi.order_id = o.id
WHERE o.status = 'PAID'
    AND o.created_at >= NOW() - INTERVAL 30 DAY
GROUP BY o.id, u.name
HAVING total > 10000
ORDER BY total DESC
LIMIT 50

정렬본에서는 JOIN이 몇 개인지, 어떤 조건이 WHERE에 걸려 있는지가 한눈에 들어옵니다. 쿼리 튜닝은 실행 계획을 보기 전에 구조부터 파악하는 일이라, 이 단계에서 이미 절반이 끝납니다.

🗄️ DBMS별 문법 차이

같은 동작이라도 DBMS마다 키워드가 다릅니다. 정렬된 쿼리를 다른 DB로 옮길 때 자주 걸리는 부분만 모았습니다.

💡 SQL 스타일 가이드

• 키워드는 대문자, 테이블/컬럼명은 소문자 권장
• JOIN은 명시적으로 (INNER JOIN, LEFT JOIN 등)
• SELECT 절의 각 컬럼은 새 줄에 작성
• WHERE 조건은 AND/OR별로 줄바꿈
• 테이블 별칭은 의미 있게 — a, b 보다 o(orders), u(users)
• 콤마는 줄 끝에 붙이는 방식이 일반적이지만, 팀 컨벤션이 우선입니다

⚠️ 정렬하면 바로 보이는 실수들

쿼리가 한 줄로 뭉쳐 있으면 놓치기 쉬운데, 줄바꿈만 넣어도 눈에 띄는 문제들입니다.

• LEFT JOIN인데 WHERE에 조건을 건 경우 — 결과적으로 INNER JOIN이 되어 행이 사라집니다. 조건은 ON 절로 옮겨야 합니다.
• AND/OR 괄호 누락 — AND가 OR보다 우선순위가 높아 의도와 다른 조건이 됩니다.
• GROUP BY 누락 컬럼 — SELECT에는 있는데 GROUP BY에 빠진 컬럼. MySQL은 넘어가지만 PostgreSQL은 에러입니다.
• 중복 JOIN — 같은 테이블을 두 번 조인해 행이 배수로 부풀어 있는 경우.
• 인덱스를 못 타는 WHERE — 컬럼에 함수를 씌운 조건(DATE(created_at) = ...)은 인덱스를 무시합니다.

자주 묻는 질문