SQL 쿼리 읽기 좋게 정리하기 — 들여쓰기·대문자 규칙

로그에서 복사한 쿼리, ORM이 만들어 준 쿼리, 동료가 메신저로 보낸 쿼리 — 대개 한 줄로 길게 늘어져 있어 WHERE 조건이 몇 개인지조차 한눈에 안 들어옵니다. SQL은 모양을 정리하는 것만으로 읽는 속도가 크게 달라집니다. 널리 쓰이는 정리 규칙을 알아봅니다.

왜 정리가 필요한가 — 한 줄 쿼리의 문제

SQL은 줄바꿈과 들여쓰기가 실행에 아무 영향을 주지 않습니다. 그래서 기계가 만든 쿼리는 대부분 한 줄입니다. 문제는 사람이 읽을 때입니다.

• 구조가 안 보입니다 — SELECT가 몇 개의 컬럼을 고르는지, JOIN이 몇 번 일어나는지 줄을 따라 눈으로 세어야 합니다.
• 실수를 놓칩니다 — 빠진 조건, 잘못된 AND/OR 묶음은 정렬된 쿼리에서 훨씬 잘 보입니다.
• 비교가 안 됩니다 — 쿼리 두 버전의 차이를 볼 때 한 줄짜리는 diff가 통째로 바뀐 것처럼 나옵니다.

널리 쓰이는 정리 규칙 4가지

1. 키워드는 대문자 — SELECT, FROM, WHERE, JOIN 같은 예약어를 대문자로 쓰면 쿼리의 뼈대가 테이블·컬럼명과 구분됩니다.
2. 절(clause)마다 줄바꿈 — SELECT, FROM, WHERE, GROUP BY, ORDER BY가 각각 새 줄에서 시작하면 쿼리의 단계가 위에서 아래로 읽힙니다.
3. 목록은 들여쓰기 — 컬럼 목록, 조건 목록은 절 아래에 한 단계 들여 씁니다. 조건이 여러 개면 AND/OR를 줄 앞에 두면 빠뜨린 조건이 잘 보입니다.
4. 서브쿼리는 괄호와 함께 한 단계 더 — 안쪽 쿼리가 바깥쪽과 같은 깊이에 있으면 어디까지가 서브쿼리인지 헷갈립니다.

포매터로 정리하기 3단계

손으로 줄을 맞추는 건 비효율적입니다. 포매터에 붙여 넣으면 위 규칙대로 한 번에 정렬됩니다.

1. 한 줄로 늘어진 쿼리를 복사해 포매터에 붙여 넣습니다.
2. 사용하는 데이터베이스(MySQL·PostgreSQL 등)에 맞는 방언을 고릅니다 — 백틱·대괄호 같은 식별자 표기가 정확해집니다.
3. 정렬된 결과를 복사해 에디터·문서·리뷰에 사용합니다.

팀에서 스타일 통일하기

• 대소문자·들여쓰기 폭을 먼저 합의 — 키워드 대문자 여부, 들여쓰기 2칸/4칸만 정해도 리뷰에서 모양 논쟁이 사라집니다.
• 커밋 전에 포매터를 거치는 습관 — 같은 도구로 정리하면 누가 작성해도 같은 모양이 나옵니다.
• diff를 깨끗하게 — 모양 변경과 로직 변경을 한 커밋에 섞지 마세요. 모양만 바꾼 커밋을 따로 두면 리뷰가 쉬워집니다.