핵심 요점
- 01PostgreSQL, MySQL, SQLite, BigQuery 및 표준 SQL을 방언 인식 키워드 처리로 지원합니다.
- 02키워드 대소문자(UPPERCASE, lowercase 또는 preserve) 및 들여쓰기(2칸, 4칸 또는 탭)를 선택하세요.
- 03브라우저에서 완전히 실행됩니다 — 민감한 데이터가 있는 쿼리는 기기를 떠나지 않습니다.
- 04도구는 텍스트만 재형식화합니다. 쿼리를 실행하거나 데이터베이스에 연결하지 않습니다.
공유하기 전에 SQL을 형식화하는 이유는?
형식화되지 않은 SQL은 검토하기 어렵습니다. 한 줄에 뭉쳐진 긴 SELECT 목록, 부분쿼리의 불일치한 들여쓰기, 혼합 대소문자 키워드는 모두 코드 검토와 디버깅을 느리게 합니다. 올바르게 형식화된 쿼리는 JOIN 조건, WHERE 절, CTE 구조를 즉시 읽을 수 있게 만듭니다.
팀 전체에 스타일 가이드와 함께 쿼리를 공유할 때 형식화가 더욱 중요합니다 — UPPERCASE 키워드, 4칸 들여쓰기, 줄당 하나의 절. Handytool의 SQL 포매터는 2줄 조회부터 여러 CTE와 윈도우 함수가 있는 200줄 분석 쿼리까지 붙여넣는 모든 것에서 이 스타일을 일관되게 적용합니다.
SQL 쿼리를 형식화하는 방법
- 01
SQL을 붙여넣으세요
SELECT, INSERT, UPDATE, DELETE, CREATE 또는 전체 CTE 체인과 같은 모든 SQL 문을 입력 패널에 붙여넣으세요. 브라우저의 사용 가능한 메모리 외에는 크기 제한이 없습니다.
- 02
방언을 선택하세요
드롭다운에서 PostgreSQL, MySQL, SQLite, BigQuery 또는 표준 SQL을 선택하세요. 방언은 RETURNING 또는 STRUCT와 같은 예약어 및 벤더별 구문이 처리되는 방식을 결정합니다.
- 03
키워드 대소문자 및 들여쓰기를 설정하세요
키워드 대소문자는 UPPERCASE, lowercase 또는 Preserve를 선택하세요. 들여쓰기는 2칸, 4칸 또는 탭을 선택하세요. UPPERCASE 키워드와 2칸 들여쓰기는 공유 코드베이스에서 가장 일반적인 스타일입니다.
- 04
형식화를 클릭하세요
형식화된 출력은 오른쪽 패널에 즉시 나타납니다. 절은 자신의 줄에 배치되고, JOIN 조건이 정렬되고, 부분쿼리는 부모를 기준으로 들여쓰기됩니다.
- 05
복사 및 사용
복사를 클릭하여 형식화된 SQL을 클립보드에 복사하세요. IDE, SQL 파일, PR 설명 또는 설명서 스니펫에 붙여넣으세요.
프로덕션 쿼리 패턴으로 사용하기에 안전합니다
sql-formatter 라이브러리는 브라우저에서 완전히 실행됩니다. 쿼리 텍스트, 테이블 이름, 샘플 데이터가 서버로 전송되지 않습니다. 이렇게 하면 실제 스키마 이름을 참조하거나 스테이징 데이터베이스의 샘플 값을 포함하는 쿼리를 형식화하기에 안전합니다.
포매터가 하지 않을 한 가지는 SQL을 실행하는 것입니다. 텍스트 변환 도구일 뿐입니다. 테이블을 삭제하거나 행을 삭제할 쿼리를 안전하게 붙여넣을 수 있습니다 — 도구는 이를 일반 텍스트로 취급하고 문 하나를 실행하지 않고 재형식화합니다.
SQL 포매터 FAQ
이 포매터는 어떤 SQL 방언을 지원합니까?
표준 SQL, PostgreSQL, MySQL, SQLite, BigQuery. 각 방언은 PostgreSQL의 RETURNING 절, MySQL의 백틱 식별자, BigQuery의 STRUCT 유형과 같은 벤더별 구문을 올바르게 처리합니다.
포매터가 쿼리를 실행합니까?
아니요. 쿼리 텍스트만 재형식화합니다. 데이터베이스에 연결하지 않으며 열 이름을 검증하거나 문을 실행하지 않습니다.
내 SQL이 서버에 업로드됩니까?
아니요. sql-formatter 라이브러리는 브라우저에서 실행됩니다. 쿼리 텍스트는 기기에 유지됩니다.
저장된 프로시저 또는 PL/pgSQL 블록이 이상하게 형식화되는 이유는 무엇입니까?
절차적 SQL 블록(PL/pgSQL, BEGIN…END 블록, DECLARE 섹션)은 포매터의 문법 범위를 벗어납니다. 해당 블록 내에서 더 작은 SELECT 또는 DML 스니펫을 별도로 형식화하세요.
공유 코드베이스에 최적의 키워드 대소문자는 무엇입니까?
UPPERCASE 키워드는 가장 널리 채택된 규칙입니다 — SQL 구조를 식별자 이름에서 시각적으로 분리합니다. 2칸 또는 4칸 들여쓰기는 팀 선호도의 문제입니다.