출력 SQL
포맷팅된 SQL이 여기에 표시됩니다
SQL 포맷팅 전/후 비교
SQL Formatter는 SQL 쿼리를 읽기 쉽게 포맷팅하거나 압축하는 도구입니다.
📝 SQL 포맷팅 (Format)
• 입력창에 SQL 쿼리를 입력하세요
• "FORMAT" 버튼을 클릭하면 읽기 쉽게 정리됩니다
• 키워드가 자동으로 정렬되고 들여쓰기가 적용됩니다
• 구문 강조로 키워드가 색상으로 표시됩니다
• "복사" 버튼으로 결과를 클립보드에 복사할 수 있습니다
🗜️ SQL 압축 (Minify)
• 입력창에 SQL 쿼리를 입력하세요
• "MINIFY" 버튼을 클릭하면 불필요한 공백이 제거됩니다
• 한 줄로 압축되어 파일 크기가 줄어듭니다
• 프로덕션 환경에서 쿼리 크기를 최소화할 때 유용합니다
⚙️ 포맷 옵션
• Uppercase Keywords: 키워드를 대문자로 변환 (SELECT, FROM 등)
• Indent Size: 들여쓰기 크기를 2 또는 4 스페이스로 선택
• Line Break AND/OR: AND/OR 앞에 줄바꿈 추가 여부
🎨 구문 강조
• SELECT, FROM, WHERE 등 주요 키워드는 청록색으로 강조
• 중첩된 쿼리도 자동으로 들여쓰기
• CASE/WHEN/THEN 문도 적절히 포맷팅
📊 통계 정보
• 포맷팅 후 입력/출력 크기와 변화율 확인
• 줄 수 표시로 쿼리 복잡도 파악
SQL Formatter는 SQL 쿼리의 가독성을 높이거나 크기를 최소화하는 도구입니다.
📖 SQL 포맷팅의 중요성
SQL 쿼리는 복잡해질수록 가독성이 떨어지고 유지보수가 어려워집니다. 특히 여러 테이블을 조인하거나 서브쿼리를 사용하는 경우, 적절한 포맷팅 없이는 로직을 이해하기 힘들어집니다. SQL Formatter는 일관된 스타일로 쿼리를 정리하여 코드 리뷰와 디버깅을 용이하게 합니다.
🔧 포맷팅 원칙
1. 주요 절(SELECT, FROM, WHERE 등)은 새 줄에 배치
2. JOIN 절은 적절히 들여쓰기
3. AND/OR 조건은 선택적으로 줄바꿈
4. 중첩 쿼리는 들여쓰기 레벨 증가
5. 키워드는 대문자로 통일 (선택사항)
💡 포맷팅 vs 압축
• 포맷팅(Formatting): 개발 환경에서 가독성 향상
- 코드 리뷰 시 쿼리 로직 파악 용이
- 디버깅 시 문제 지점 빠르게 식별
- 팀 내 코딩 스타일 통일
• 압축(Minify): 프로덕션 환경에서 크기 최소화
- 네트워크 전송량 감소
- 저장 공간 절약
- 쿼리 문자열 길이 제한 회피
🎯 주요 사용 사례
• 레거시 코드의 SQL 쿼리 정리
• 팀 내 SQL 코딩 컨벤션 적용
• ORM이 생성한 복잡한 쿼리 분석
• 데이터베이스 마이그레이션 스크립트 정리
• SQL 교육 자료 작성
• 쿼리 최적화 전 구조 파악
⚠️ 주의사항
• 압축된 SQL은 가독성이 떨어지므로 개발 시 사용하지 마세요
• 데이터베이스별로 문법 차이가 있을 수 있습니다
• 주석은 포맷팅 과정에서 유지되지 않을 수 있습니다
• 복잡한 함수나 저장 프로시저는 수동 조정이 필요할 수 있습니다
💡 SQL Formatter 활용 가이드
1. 코드 리뷰 준비
팀 내 코드 리뷰 전에 SQL 쿼리를 포맷팅하여 일관된 스타일로 제출하세요. 리뷰어가 로직에 집중할 수 있도록 가독성을 높입니다.
2. ORM 쿼리 분석
Hibernate, TypeORM 등 ORM이 생성한 복잡한 쿼리를 포맷팅하면 실제 실행되는 SQL을 쉽게 이해할 수 있습니다.
3. 성능 분석 준비
EXPLAIN PLAN을 사용하기 전에 쿼리를 포맷팅하면 실행 계획과 쿼리 구조를 함께 비교하기 쉽습니다.
4. 문서화
프로젝트 문서나 API 명세서에 SQL 예제를 포함할 때 포맷팅된 쿼리를 사용하세요.
5. 교육 자료
SQL 교육 시 포맷팅된 쿼리를 사용하면 초보자가 구조를 이해하기 쉽습니다.
6. 버전 관리
Git 커밋 전에 SQL 쿼리를 일관되게 포맷팅하면 diff 비교가 명확해집니다.
7. 들여쓰기 설정
팀의 코딩 컨벤션에 따라 2 스페이스 또는 4 스페이스 들여쓰기를 선택하세요.
8. AND/OR 줄바꿈
복잡한 WHERE 절이 있는 경우 AND/OR 줄바꿈 옵션을 활성화하여 조건을 명확히 구분하세요.
9. 데이터베이스별 차이
• MySQL: LIMIT 사용
• PostgreSQL: LIMIT/OFFSET 사용
• SQL Server: TOP 또는 OFFSET FETCH 사용
• Oracle: ROWNUM 또는 OFFSET FETCH 사용
10. IDE 통합
포맷팅된 쿼리를 IDE의 SQL 에디터에 붙여넣어 하이라이팅과 자동완성을 활용하세요.