작동 원리 및 구조
`sql-formatter`의 DB 방언별 어휘 토크나이저를 사용해 JOIN, 서브쿼리, CTE, `WHERE` 절을 안전하게 재들여쓰기하며, 문자열·식별자 인식 압축 모드는 따옴표 안의 리터럴을 망가뜨리지 않고 불필요한 공백과 `--` / `/* */` 주석만 깔끔히 제거합니다.
단계별 사용 방법
원본 SQL 쿼리, ORM 실행 로그 또는 마이그레이션 스크립트를 입력란에 붙여넣습니다.
사용 중인 데이터베이스 방언(PostgreSQL, MySQL, SQLite, T-SQL, BigQuery 또는 Standard SQL)을 선택합니다.
키워드 대소문자(`UPPERCASE`, `lowercase`, `유지`)와 2칸/4칸 들여쓰기를 고릅니다.
정렬(Beautify) 또는 압축(Minify)을 전환한 뒤 'SQL 복사'를 클릭해 에디터에 붙여넣습니다.
주요 기능 및 장점
- PostgreSQL(`$1`, JSONB 연산자), MySQL, SQLite, T-SQL, BigQuery 문법에 맞춘 정확한 방언별 포맷팅
- 리터럴 안전 SQL 압축기: 따옴표로 감싼 문자열 내용은 보존하면서 주석과 여백만 제거
- 키워드 대소문자(`UPPERCASE` / `lowercase` / `Preserve`) 및 탭 들여쓰기 설정 가능
- 실시간 쿼리 진단 정보(구문 수 및 포맷된 줄 수) 표시
- 100% 브라우저 사이드: 사내 테이블 스키마명이나 민감한 운영 로그 쿼리도 안전하게 정리
계산 방식, 공식 및 기술 표준
토큰화 과정에서 따옴표로 묶인 식별자와 문자열 상수는 원본 그대로 보존하면서 각 SQL 방언 문법에 따라 절(Clause) 들여쓰기 계층과 연산자 간격만 정규화합니다.
실제 활용 사례
- 디버깅을 위해 Prisma, TypeORM, Drizzle에서 출력된 빽빽한 한 줄짜리 SQL 로그를 가독성 있게 펼치기
- 코드 리뷰 전 팀 내 SQL PR 변경점(Diff)의 키워드 대소문자와 들여쓰기 스타일 통일
- 여러 줄의 분석 쿼리를 JSON 설정 파일에 넣기 편한 깔끔한 한 줄 문자열로 압축
- 오프라인 환경에서 BigQuery 또는 PostgreSQL CTE 파이프라인 쿼리 구조 검토
입출력 예시 및 엣지 케이스
PostgreSQL Query Expansion
select id,email from users where active=true order by id desc limit 10;
SELECT id, email FROM users WHERE active = true ORDER BY id DESC LIMIT 10;
Aligns SELECT columns, predicates, and sorting clauses automatically.
Comment-Safe Minification
-- prod check SELECT count(*) FROM orders;
SELECT count(*)FROM orders;
Drops line comments while keeping quoted string tokens intact.
제한 사항 및 정확도 안내
- • 절차적 확장 구문(`PL/pgSQL`의 `$$` 블록이나 벤더 전용 트리거)은 경우에 따라 일반 표준 들여쓰기 규칙으로 처리될 수 있습니다.
- • 본 도구는 오프라인 구문 포맷팅만 수행하며 실제 데이터베이스에 접속해 테이블·컬럼 존재 여부를 검증하지는 않습니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. SQL 포맷터 · 쿼리 정렬 & 압축기 (PostgreSQL · MySQL · BigQuery) 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
어떤 SQL 데이터베이스 방언(Dialect)을 지원하나요?
PostgreSQL, MySQL, SQLite, Microsoft SQL Server(T-SQL), Google BigQuery 및 ANSI 표준 SQL을 지원합니다.
SQL 압축(Minify)을 하면 문자열 리터럴 안의 작은따옴표나 공백도 망가지나요?
아니요. 압축기가 따옴표로 감싸진 문자열과 식별자 경계를 문자 단위로 확인한 뒤 바깥쪽 여분의 공백만 줄이므로 문자열 내용은 100% 안전합니다.
정렬 과정에서 사내 DB 스키마나 쿼리가 네트워크로 전송되나요?
아니요. 모든 렉싱과 재포맷팅은 클라이언트 브라우저의 JavaScript에서만 실행됩니다.
세미콜론(;)으로 구분된 여러 개의 SQL 문장을 한꺼번에 정렬할 수도 있나요?
네. 여러 구문을 한 번에 넣으면 빈 줄로 깔끔하게 구분해 정렬하고 상단에 총 구문 개수도 집계해 줍니다.