SQL 포맷팅 규칙

SQL은 쓰기보다 읽기가 많습니다. 200줄 분석 쿼리는 수십 번 리뷰됩니다.

키워드 케이스

UPPER 또는 lower. 팀 전체로 하나 선택하고 포매터로 강제.

들여쓰기

SELECT

    u.id,
    COUNT(o.id) AS order_count
FROM
    users u
    LEFT JOIN orders o ON o.user_id = u.id
WHERE
    u.created_at > NOW()
GROUP BY
    u.id;

주요 절은 컬럼 0에서 시작.

별칭

다중 테이블 쿼리에서 항상 테이블 별칭. 파생 컬럼 명시적 별칭.

JOIN 스타일

JOIN 타입 항상 명시. 암묵적 콤마 조인 금지.

CTE > 서브쿼리

WITH active_users AS (...)

SELECT * FROM active_users;

상단에서 하단으로 선형, 따라가기 쉬움.

자동 포매터

• sqlfluff
• pg_format
• prettier-plugin-sql

pre-commit에서 실행.