SQL 포맷 가이드
이 페이지는 아직 한국어로 번역되지 않아 영어로 표시됩니다.
사람이 읽고, 리뷰하고, 유지보수할 수 있는 SQL을 작성하기 위한 실용 가이드입니다. 스타일 규칙, 복잡한 쿼리, 팀 워크플로, 방언 간 차이를 다룹니다. 이 페이지들의 모든 포맷 예제는 SQL Format 엔진이 직접 생성했습니다.
- SQL 스타일 가이드 명명, 키워드 대소문자, 들여쓰기, 별칭, 명시적 JOIN, 주석, CTE: 팀이 실제로 지킬 수 있는 실용적인 규칙 모음.
- 복잡한 SQL 쿼리를 포맷하는 방법 CTE, 중첩 서브쿼리, CASE, 윈도 함수, UNION: 한 화면 이상 이어지는 쿼리를 배치하는 방법.
- SQL의 앞 쉼표와 뒤 쉼표 두 쉼표 스타일 심층 비교: diff, 열 주석 처리, 훑어보기, 각 스타일이 막아 주는 오류.
- 코드 리뷰와 버전 관리를 위한 SQL 포맷 일관된 포맷으로 diff를 깔끔하게 유지하는 법, 팀 표준을 도입하는 법, 풀 리퀘스트에서 SQL을 리뷰하는 법.
- SQL 가독성을 해치는 흔한 실수 암시적 조인, SELECT *, 한 글자 별칭, AND/OR 혼용 등 SQL을 읽기 어렵게 만드는 흔한 습관과 고치는 방법.
- PostgreSQL 쿼리와 PL/pgSQL 포맷 캐스트, 파라미터, RETURNING, ON CONFLICT, 달러 인용 PL/pgSQL 본문: 포매터가 PostgreSQL 구문을 처리하는 방식.
- 포맷에 영향을 주는 SQL 방언 차이 주요 데이터베이스의 식별자 인용, LIMIT·FETCH FIRST·TOP, 배치 구분자, 절차적 블록.
- 마이그레이션 배포 전 SQL 포맷 체크리스트 스키마 또는 데이터 마이그레이션을 리뷰와 운영 환경에 올리기 전에 점검할 짧은 체크리스트.