이 글에서 소개한 도구
글을 읽으면서 브라우저에서 바로 도구를 열어 작업 흐름을 직접 확인해 보세요.
“이 쿼리, 너무 빽빽해서 읽을 수가 없네…”
운영 시스템이 한 줄로 뭉쳐 뱉어낸 거대한 SQL 쿼리. 혹은 중첩된 JOIN이 미로처럼 쌓인 스토어드 프로시저. “이 조건은 어디서 갈라지는 거지?”—이런 SQL 벽을 마주하는 건 익숙한 좌절감입니다.
**SQL 포매터**는 붙여넣은 SQL을 완전히 브라우저 안에서 재정리합니다. 민감한 프로덕션 쿼리도 절대 밖으로 나가지 않습니다.

정리 전/후
select users.id,users.name,count(orders.id) from users left join orders on users.id=orders.user_id where users.deleted_at is null group by users.id,users.name order by users.id desc;
SELECT
users.id,
users.name,
COUNT(orders.id)
FROM users
LEFT JOIN orders ON users.id = orders.user_id
WHERE users.deleted_at IS NULL
GROUP BY
users.id,
users.name
ORDER BY users.id DESC;
레이아웃만 정돈해도 빠진 조건, JOIN의 방향, 집계 단위를 훨씬 쉽게 알아챌 수 있습니다.
왜 “방언(dialect)” 선택이 필수인가
SQL 포맷터는 줄바꿈과 들여쓰기를 결정하기 전에 토큰화하고 문법을 이해해야 합니다. 즉 방언별 확장 문법이 정리의 성패를 직접 좌우합니다.
| 방언 차이 | 표준 SQL | MySQL | PostgreSQL | BigQuery |
|---|---|---|---|---|
| 식별자 인용 | "name" |
`name` |
"name" |
`project.dataset.table` |
| 문자열 결합 | || |
CONCAT() |
|| |
|| |
| LIMIT 구문 | LIMIT n |
LIMIT n |
LIMIT n OFFSET m |
LIMIT n |
| 배열/구조체 | 비표준 | 미지원 | ARRAY[...] |
STRUCT<...> |
예를 들어 MySQL의 백틱 인용 식별자를 표준 SQL로 파싱하면, 토큰 경계가 어긋나 정리 결과가 완전히 깨질 수 있습니다. “정리 결과가 이상하다”는 문제의 대부분은 방언을 잘못 선택했기 때문입니다. 이 도구는 PostgreSQL, MySQL, MariaDB, SQL Server, BigQuery 등 주요 방언을 지원하며, 실제로 사용 중인 데이터베이스에 맞춰 선택하면 방언을 바꿀 때마다 자동으로 재정리됩니다.
포맷 옵션과 템플릿·저장 스크립트 대응
SQL 포매터에는 결과의 모양을 정하는 옵션이 열한 가지 있습니다.
| 옵션 | 선택지 | 효과 |
|---|---|---|
| 키워드 대소문자 | 그대로 / 대문자 / 소문자 | 예: select를 SELECT로 통일 |
| 들여쓰기 | 스페이스 2 / 스페이스 4 / 탭 | 팀의 규칙에 맞춤 |
AND / OR의 위치 |
줄 앞 / 줄 끝 | 조건을 추가하거나 지울 때 diff를 작게 하려면 줄 앞이 알맞음 |
| 한 줄의 최대 너비 | 좁게(30) / 50 / 넓게(80) | 작을수록 세로로 길어지고 괄호 안에서도 줄바꿈이 잘 일어남 |
| 함수 이름 대소문자 | 그대로 / 대문자 / 소문자 | COUNT(*)와 count(*)를 통일. 키워드와 따로 지정할 수 있음 |
| 데이터 타입 대소문자 | 그대로 / 대문자 / 소문자 | VARCHAR(10)와 varchar(10)를 통일 |
| 식별자(테이블·열 이름) 대소문자 | 그대로 / 대문자 / 소문자 | 따옴표가 붙은 식별자("Name", `name`)는 바꾸지 않음 |
| 키워드 정렬 | 표준 / 왼쪽 / 오른쪽 | 왼쪽·오른쪽(리버 형식)은 SELECT·FROM·WHERE를 세로로 맞추고 내용을 같은 위치에서 시작 |
| 연산자 공백 | 있음 / 없음 | 없음으로 하면 a=1, a+b처럼 붙여 씀 |
| 세미콜론 | 줄 끝 / 단독 줄 | 단독 줄로 하면 문장 끝에 ;만 있는 줄이 붙음 |
| 쿼리 사이의 빈 줄 | 1 / 2 / 3 | 여러 문장을 포맷할 때 문장 사이의 빈 줄 수 |
입력한 SQL이 다른 방언의 문법(ON CONFLICT, TOP, AUTO_INCREMENT 등)으로 보이면 「이 SQL은 PostgreSQL 문법으로 보입니다」라고 알리고 전환을 제안합니다. 마음대로 바꾸지 않으며, 모든 방언에 통하는 문법만 있을 때는 아무것도 표시하지 않습니다.
실무의 SQL에는 그대로는 구문 오류가 되는 표기도 섞여 있습니다. 다음은 내용을 깨뜨리지 않고 포맷할 수 있습니다.
- 템플릿 변수: dbt·Jinja의
{{ ref('orders') }}·{% if … %}·{# … #}, 셸·JS의${var}는 하나의 덩어리로 취급됩니다 - SQL Server의
GO: 방언으로 SQL Server(T-SQL)를 고르면GO만 있는 줄로 배치를 나누고, 배치별로 포맷합니다. 문자열이나 주석 안의go는 구분자로 보지 않습니다 - MySQL의
DELIMITER:DELIMITER //같은 줄이 있는 스크립트도 구분자별로 문장을 잘라 포맷하므로//가 쪼개지지 않습니다
반대 방향인 ‘압축’ 버튼은 공백·줄바꿈·주석을 줄여 한 줄로 만듭니다. 문자열 리터럴 안은 바꾸지 않습니다(주석은 삭제됩니다). 로그나 설정 파일에 한 줄로 넣고 싶을 때 씁니다.
SQL 리뷰에서 확인할 점
정리한 뒤에는 몇 가지를 더 확인하면 리뷰의 질이 올라갑니다.
WHERE조건이 의도한 대로 동작하는가JOIN조건이 빠지지 않았는가LEFT JOIN과INNER JOIN의 선택이 올바른가(SQL JOIN 완전 레퍼런스에서 전체 내용을 다룹니다)GROUP BY의 집계 단위가 예상과 같은가- 필요한 곳에
ORDER BY나LIMIT이 들어있는가 - 서브쿼리와 CTE가 각각 명확한 역할을 하는가
로그에서 뽑아낸 SQL은 플레이스홀더가 전부 전개되어 있어 특히 길어지기 쉽습니다. 읽기 전에 정리하는 것만으로 조사 시간을 크게 줄일 수 있습니다.
정리는 “보기 좋게”만이 아니다
포맷터를 거치는 진짜 가치는 겉모습보다 다음 3가지 효과에 있습니다.
- 구문 오류의 조기 발견 — 파싱 실패는 어딘가 깨졌다는 뜻. 실행 전 무료 검증이 됩니다
- 안정적인 diff — 정리 규칙을 고정하면 쿼리 변경의 diff가 실질적인 변경분만 남습니다
- 기계 생성 SQL 해독 — ORM이 뱉어낸 한 줄짜리 쿼리는 정리하고 나서야 무엇을 JOIN하는지 보입니다
첫 번째는 특히 놓치기 쉽습니다. 괄호 개수가 안 맞거나 쉼표가 빠진 실수는 정리 처리가 실패하는 것으로 알아챌 수 있어, 실행 전에 미리 잡아낼 수 있습니다.
정리와 삽입, 다른 데이터베이스용으로 다시 쓰기
포맷팅 외에도 SQL 포매터는 붙여 넣은 SQL을 정리하고, 코드에 삽입하고, 다른 데이터베이스용으로 다시 쓸 수 있습니다.
정리와 삽입
- 주석 제거:
--와/* */를 제거합니다. 동작에 영향을 주는 MySQL의/*! … */와 옵티마이저 힌트/*+ … */는 남깁니다 - 식별자 따옴표 바꾸기: MySQL의
`x`, PostgreSQL / SQLite의"x", SQL Server의[x]사이에서 바꿉니다. 따옴표를 없애는 것은 영문 소문자·숫자·_만으로 이루어지고 예약어가 아닌 이름뿐입니다 - 코드용 문자열로 감싸기: JavaScript(템플릿 리터럴), Python(삼중 따옴표), Java(텍스트 블록), Go, PHP, C#, JSON
- 코드의 문자열에서 SQL 꺼내기:
"SELECT … " + "FROM …"같은 연결과\n이스케이프를 읽어 SQL로 되돌립니다. 로그나 소스에서 복사한 쿼리를 바로 포맷팅할 수 있습니다
다른 데이터베이스용으로 다시 쓰기
MySQL·PostgreSQL·SQLite·SQL Server 사이에서 기계적으로 고칠 수 있는 부분을 다시 씁니다. 문자열·주석·따옴표로 감싼 식별자는 건드리지 않습니다.
| 항목 | 예 |
|---|---|
| 식별자 따옴표 | `id` → "id" → [id] |
| 행 수 제한 | LIMIT 10, 5 → LIMIT 5 OFFSET 10. SQL Server로는 TOP (n) / OFFSET … FETCH |
| NULL 대체 | IFNULL(a, 0), ISNULL(a, 0) ⇄ COALESCE(a, 0) |
| 현재 시각 | NOW() ⇄ GETDATE() ⇄ CURRENT_TIMESTAMP |
| 문자열 집계 | GROUP_CONCAT(x SEPARATOR ',') ⇄ STRING_AGG(x, ',') |
| 캐스트 | a::int → CAST(a AS int) |
| 타입·자동 증가(CREATE TABLE) | AUTO_INCREMENT ⇄ SERIAL ⇄ IDENTITY(1,1), TINYINT(1) → BOOLEAN, DATETIME → TIMESTAMP 등 |
기계적으로 고칠 수 없는 것은 그대로 두고 「직접 확인할 것」으로 목록에 보여 줍니다. ILIKE(LIKE로 바꾸고 대소문자 처리 차이를 안내), ||(MySQL에서는 OR), RETURNING, UPSERT(ON CONFLICT와 ON DUPLICATE KEY UPDATE 등), ORDER BY가 있는 GROUP_CONCAT, MySQL의 백슬래시 이스케이프 등입니다. 결과는 출발점입니다. 방언마다 의미 차이가 많으므로 반드시 실제 데이터베이스에서 시험하세요.
자주 묻는 질문
MySQL이나 PostgreSQL의 SQL도 지원하나요?
네. 표준 SQL, MySQL, PostgreSQL, MariaDB, SQL Server, BigQuery 등 주요 방언에 맞춰 정리할 수 있습니다. 방언 고유의 구문이 포함된 경우에도 실행 전에는 반드시 직접 확인하세요.
정리하면 SQL의 의미가 바뀌나요?
아니요. 정리는 공백·줄바꿈·들여쓰기·대소문자만 조정하는 처리로, 쿼리의 의미(실행 결과)는 바뀌지 않습니다. 다만 실행 전에는 항상 원래 SQL과 의도가 달라지지 않았는지 확인하는 것이 안전합니다.
방언을 잘못 선택하면 어떻게 되나요?
식별자의 인용 방식이나 키워드 해석이 어긋나면서 들여쓰기가 깨지거나 예상치 못한 위치에서 줄바꿈이 일어날 수 있습니다. “정리 결과가 이상하다”고 느껴진다면 먼저 방언 선택을 다시 확인하세요.
기밀 데이터가 포함된 SQL을 붙여넣어도 괜찮나요?
네. 정리는 모두 브라우저 안에서 완결되며 네트워크 통신이 발생하지 않습니다. 테이블명이나 컬럼명이 포함된 쿼리도 외부로 전송되지 않습니다.
MySQL용 SQL을 PostgreSQL이나 SQL Server용으로 변환할 수 있나요?
따옴표, LIMIT, IFNULL / COALESCE, NOW(), GROUP_CONCAT / STRING_AGG, :: 캐스트, CREATE TABLE의 타입과 AUTO_INCREMENT처럼 기계적으로 고칠 수 있는 부분은 다시 씁니다. ILIKE, ||, UPSERT, RETURNING처럼 의미가 바뀌는 것은 다시 쓰지 않고, 직접 확인할 항목으로 목록에 보여 줍니다. 같은 결과가 나온다는 보장은 없으므로, 실행 전에 실제 데이터베이스에서 확인하세요.
정리
- 포맷터 본체는 라이브러리에 한 줄 위임하는 수준이지만, 방언 선택이 결과를 좌우하는 본질적인 파라미터
- 식별자 인용 부호 하나로 파싱이 달라지므로 사용 중인 DB에 맞춰 방언을 선택해야 합니다
- 정리는 보기 좋게 만드는 것을 넘어 구문 오류 조기 발견·diff 안정화·기계 생성 SQL 해독에 효과가 있습니다
로그에서 쿼리를 뽑아냈다면, 읽기 전에 먼저 포맷터에 통과시켜 보세요.
