SQL 보기 좋게 출력하기: 지저분한 쿼리를 몇 초 만에 정리하는 법

SQL Pretty Print란 무엇인가?

SQL을 pretty print한다는 것은 쿼리의 구조가 한눈에 보이도록 재포맷하는 것입니다. 키워드가 정렬되고, 각 절이 별도의 줄에 위치하며, 중첩된 조건이 들여쓰기되고, 컬럼 목록이 깔끔하게 정리됩니다. 쿼리는 어느 쪽이든 동일하게 실행됩니다 — 데이터베이스는 공백을 무시합니다 — 하지만 포맷팅된 쿼리는 사람이 읽고 검토하고 디버깅하기가 훨씬 쉽습니다.

실무에서는 SQL이 못생긴 형태로 오는 경우가 많습니다. ORM이 생성하거나, 로그에서 복사하거나, 채팅 메시지에서 붙여 넣거나, 급하게 작성하고 정리하지 않은 경우가 그렇습니다. 세 개의 조인과 중첩 서브쿼리가 있는 300자짜리 한 줄 SELECT는 텍스트 덩어리입니다. 포맷팅을 하면 실제로 이해할 수 있는 형태로 바뀝니다.

포맷팅 전후 비교

포맷팅되지 않은 쿼리는 보통 이런 형태입니다: “select u.id, u.name, o.total from users u join orders o on o.user_id = u.id where o.status = 'paid' and o.total > 100 order by o.total desc”. 맞는 쿼리지만 단어 하나하나를 파싱해야 합니다.

Pretty print하면 각 절이 별도의 줄에 위치합니다 — SELECT와 컬럼들, FROM, ON 조건이 있는 JOIN, 필터가 있는 WHERE, 마지막에 ORDER BY. 쿼리의 구조가 명확해지고, 누락된 조인 조건이나 잘못된 위치의 필터가 줄 중간에 숨어 있는 대신 눈에 띄게 됩니다.

2초의 시간을 들일 가치가 있는 이유

• 더 빠른 디버깅 — 대부분의 SQL 버그는 구조적입니다. 잘못된 컬럼의 조인, 잘못된 절의 필터, 불필요한 AND 등. 깔끔한 들여쓰기가 이런 문제를 눈에 보이게 합니다.
• 더 나은 코드 리뷰 — 리뷰어가 포맷팅된 쿼리를 따라가며 문제를 발견할 수 있습니다. 한 줄 쿼리는 아무도 읽을 수 없어서 그냥 승인됩니다.
• 일관된 스타일 — 포맷터는 매번 동일한 대소문자와 들여쓰기 규칙을 적용하므로 팀 전체의 쿼리가 통일된 형태를 가집니다.
• 더 안전한 편집 — 각 절이 별도의 줄에 분리되어 있으면 하나의 조건을 변경할 때 다른 조건을 실수로 깨뜨릴 가능성이 훨씬 낮아집니다.

SQL 방언별 포맷팅

MySQL, PostgreSQL, SQL Server, Oracle은 동일한 핵심 문법을 공유하지만 인용 스타일, 특정 함수, 일부 키워드에서 차이가 있습니다. 좋은 포맷터는 이런 방언을 이해하여 방언별 문법을 망치지 않고 올바르게 들여쓰기하고 정렬합니다. 여러 데이터베이스를 함께 사용한다면 방언을 선택할 수 있는 포맷터를 선택하세요.

브라우저에서 비공개로 처리하기

쿼리에는 테이블 이름, 컬럼 이름, 외부에 노출하고 싶지 않은 구조가 포함되어 있는 경우가 많습니다. 완전히 클라이언트 사이드에서 실행되는 포맷터는 쿼리를 사용자의 기기에 유지합니다 — 아무것도 업로드되지 않으며, SQL이 민감한 내용을 다룰 때 특히 중요합니다.

무료 SQL 포맷터 열기 — 쿼리를 붙여 넣으면 즉시 pretty print, 들여쓰기, 정렬이 완료됩니다. MySQL, PostgreSQL, SQL Server, Oracle을 지원합니다. 회원가입 불필요, 브라우저에서만 실행됩니다.