SQL 문을 들여쓰기하고 키워드를 대문자로 정리하는 방법

SQL 텍스트를 읽기 좋게 정리하는 범위

SQL Formatter는 SQL 텍스트의 모양을 정리하는 도구입니다. 한 줄에 몰린 문장을 다시 나눌 수 있습니다. 절의 위치를 읽기 쉽게 바꿀 수 있습니다. SQL 키워드를 대문자로 표시할 수 있습니다. 입력한 내용을 실행하지는 않습니다. 데이터베이스에 접속해 조회 결과를 만들지도 않습니다. 따라서 이 도구는 실행 전 텍스트 정리에 맞습니다. 코드 리뷰 전 서식 통일에도 쓸 수 있습니다. 공유 전 가독성 점검에도 활용할 수 있습니다. 긴 문장을 짧은 줄로 나누면 구조를 살피기 쉽습니다. 키워드 표기가 통일되면 절을 찾기 편합니다. 다만 보기 좋은 출력이 쿼리 결과를 뜻하지는 않습니다. 서식 결과와 실행 결과는 서로 다른 대상입니다. 먼저 정리할 SQL을 준비하세요. 다음으로 들여쓰기 폭을 생각하세요. 방언 입력이 필요하면 그 값도 준비할 수 있습니다. 입력이 없을 때의 동작도 미리 알아두면 혼동을 줄일 수 있습니다.

입력부터 형식 결과 확인까지

정리할 SQL을 입력합니다. 입력란에는 문자열을 넣어야 합니다. 숫자나 다른 형식의 값은 SQL 텍스트로 처리되지 않습니다. 입력을 생략하면 기본적으로 빈 값이 사용됩니다. 공백만 넣은 경우에는 별도의 SQL 문장을 찾지 않습니다. 이 경우 빈 형식 결과가 반환됩니다. 예전 입력 이름인 sql에 값이 남아 있고 기본 입력이 비어 있으면 그 값이 대신 사용됩니다. 두 입력을 함께 다룰 때는 현재 입력의 상태를 먼저 확인하세요.
입력 크기를 살핍니다. 비어 있지 않은 SQL은 UTF-8 기준 1,000,000바이트 이하로 준비하세요. 이 크기를 넘는 입력은 형식 지정 전에 거부될 수 있습니다. 긴 파일은 필요한 구간으로 나누는 편이 좋습니다. 주석과 공백도 입력 크기에 포함될 수 있으므로 여유를 두세요. 잘라낼 때는 문장 중간보다 문장 단위의 구분을 우선하세요.
들여쓰기 값을 정합니다. 기본값은 2입니다. 비어 있지 않은 입력에서는 값이 정수로 변환됩니다. 변환에 실패하면 2가 사용됩니다. 변환된 값이 0보다 작아도 2로 돌아갑니다. 변환된 값이 8보다 커도 2로 바뀝니다. 0부터 8 사이의 변환값은 그대로 적용됩니다. 예를 들어 4를 넣으면 성공한 형식 결과에서 지정된 들여쓰기 폭이 사용됩니다. 숫자로 읽히지 않는 문자를 넣을 때는 기본값으로 바뀔 수 있음을 기억하세요. 공백만 있는 입력은 이 변환보다 먼저 빈 결과를 반환합니다. 따라서 같은 들여쓰기 값이라도 입력 내용에 따라 확인 지점이 달라집니다.
필요할 때 방언 값을 입력합니다. 이 값은 입력으로 받을 수 있습니다. 그러나 현재 형식 지정 과정은 방언별 파싱 규칙을 선택하지 않습니다. 특정 방언을 적었다고 해서 그 방언 전용 서식이 적용되는 것은 아닙니다. 방언을 입력한 뒤에도 SQL 문장의 형태를 따로 살펴야 합니다.
형식 지정을 실행합니다. 파싱과 형식 지정이 성공하면 입력 SQL의 들여쓰기가 다시 적용됩니다. SQL 키워드는 대문자로 표시됩니다. 여러 문장이 인식되면 문장 사이가 세미콜론과 줄바꿈으로 구분됩니다. 결과의 마지막에는 세미콜론 하나가 붙습니다. 출력이 나타나면 첫 줄부터 절의 순서와 들여쓰기 폭을 확인하세요. 한 문장만 넣었다면 문장 끝의 세미콜론도 살펴보세요. 처리되지 않으면 입력이 실제 문자열인지 점검하세요. 이어서 공백뿐인 값인지 확인하세요. SQL 문장이 인식될 수 있는 형태인지도 다시 읽어 보세요. 형식 지정 중 예외가 발생했을 가능성도 남아 있습니다.

출력의 의미와 확인할 경계

성공한 출력은 원문을 실행한 결과가 아니라 다시 배치한 SQL 텍스트입니다. 키워드의 대문자 표기는 형식 지정이 적용되었다는 신호로 볼 수 있습니다. 줄바꿈과 들여쓰기는 문장의 구조를 파악하는 데 도움을 줍니다. 여러 문장을 넣었다면 세미콜론 뒤의 줄바꿈을 문장 경계로 읽으세요. 마지막 세미콜론은 출력 형식의 일부입니다. 이 표시는 데이터베이스가 문장을 승인했다는 뜻이 아닙니다. 결과가 비어 있으면 공백만 있는 입력이었는지 먼저 살펴보세요. 비어 있지 않은 값인데 결과가 없거나 오류가 나면 SQL 문장이 감지되었는지 확인하세요. 파싱 라이브러리를 사용할 수 없거나 파싱 및 형식 지정 중 예외가 생겨도 처리가 실패할 수 있습니다. 방언 값을 넣었다면 방언 전용 검증이 끝났다고 해석하지 마세요. 출력의 가독성은 확인할 수 있지만 실행 가능성은 별도 절차로 판단해야 합니다. 필요한 경우 정리된 텍스트를 개발 환경에서 따로 검토하세요.

사용 예시

개발자가 한 줄로 작성한 SELECT 문을 검토하기 쉬운 여러 줄 형태로 바꾸려 합니다.

개발자가 짧은 SELECT 문을 입력하고 들여쓰기 값을 4로 지정한 다음 형식 지정을 실행합니다.

키워드가 대문자로 표시되고 절이 여러 줄로 나뉘며, 한 문장의 끝에 세미콜론이 붙은 텍스트가 반환됩니다.

제한 사항

방언별 규칙은 적용되지 않으며 SQL 문장 감지 실패나 파싱·형식 지정 중 예외로 인해 비어 있지 않은 입력도 처리되지 않을 수 있습니다.

자주 발생하는 오류

긴 SQL 전체를 한 번에 넣어 크기 제한에 걸릴 수 있습니다. 불필요한 부분을 덜어 내고 문장 단위로 나눈 뒤 다시 입력하세요.

자주 묻는 질문

SQL 입력을 비워 두면 어떤 결과가 나오나요?

입력이 비어 있거나 공백만 있으면 빈 형식 결과가 나옵니다. 비어 있지 않은 입력은 파싱과 형식 지정이 성공해야 정리된 텍스트를 얻을 수 있습니다.

들여쓰기 값은 어떤 규칙으로 처리되나요?

비어 있지 않은 입력에서는 기본 들여쓰기 값이 2로 시작합니다. 값을 정수로 바꿀 수 없거나 변환값이 0보다 작거나 8보다 크면 2가 사용되며, 그 범위 안의 변환값은 적용됩니다.

MySQL이나 PostgreSQL 같은 SQL 방언을 지정할 수 있나요?

방언 값 자체는 입력할 수 있지만, 현재 과정에서 방언별 파싱이나 서식 규칙을 선택하지는 않습니다. 그러므로 특정 방언의 구문 검증이나 전용 서식이 적용되었다고 판단하면 안 됩니다.