// 무료 도구

PostgreSQL 포맷터

브라우저에서 PostgreSQL을 포맷합니다. 캐스트, 달러 인용 본문, JSONB 연산자, 배열을 Postgres가 읽는 방식으로 읽어 들이므로 포매터는 공백과 요청한 대소문자만 바꿉니다.

여기에 .sql 파일을 드롭하면 열 수 있습니다. 파일은 업로드되지 않고 브라우저에서 읽힙니다.

포맷된 SQL
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

Loading the formatter…

편집기 단축키: Ctrl+엔터 형식 및 Ctrl+Shift+엔터 축소(⌘ 다음 대신 Ctrl 사용). 이 브라우저에서 설정이 저장되고 페이지 주소에 유지되므로 링크를 공유하면 스타일만 공유되며 SQL은 공유되지 않습니다.

포맷터가 PostgreSQL SQL을 처리하는 방식

  • 연산자를 Postgres가 읽는 방식으로 해석합니다. PostgreSQL은 연속된 연산자 문자를 하나의 연산자로 다루고, 포맷터도 마찬가지입니다: ->>, #>>, @>, <@, ?|, || 그리고 직접 정의한 커스텀 연산자는 절대 분리되지 않고, 반면 x>=-1 여전히 다음과 같이 읽힙니다 x >= -1.
  • 캐스팅과 배열은 그대로 유지됩니다. created_at::date 컴팩트하게 유지되고 ARRAY['a','b'], tags[1], tags[2:3] 그리고 text[] 작성된 그대로 유지됩니다.
  • 달러 인용 본문은 손대지 않습니다. 다음의 본문은 $$ … $$ 또는 $tag$ … $tag$ 문자열(예: 함수나 DO 블록은 들어갈 때와 정확히 같은 모습으로 나옵니다.
  • 매개변수와 리터럴은 그대로 유지됩니다. $1 플레이스홀더, psql :variables, E'…' 문자열 이스케이프, B'…' 그리고 X'…' 비트 문자열과 U&'…' 유니코드 문자열은 각각 하나의 토큰입니다.
  • 대소문자에 안전한 인용. PostgreSQL은 따옴표 없이 쓴 이름을 소문자로 바꾸므로 불필요한 따옴표 제거 는 이미 소문자인 이름만 따옴표를 벗깁니다. "Users" 따옴표는 그대로 유지됩니다.
  • Postgres 키워드에도 지정한 대소문자가 적용됩니다, 다음을 포함해서 RETURNING, ILIKE, LATERAL, INTERVAL '7 days' 그리고 NULLS LAST.

알아 두면 좋은 정보

  • 함수 본문 안의 SQL은 포매터에게 문자열로 취급되므로 작성된 대로 유지되며 재포맷되지 않습니다.

예시

PostgreSQL 이전과 이후

이전
select id, payload->>'kind' as kind, payload#>>'{user,id}' as user_id, tags[1] as first_tag from events where tags @> array['beta']::text[] and payload ? 'source' and created_at > now() - interval '7 days' order by created_at desc nulls last limit 50;
변경 후
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

출력은 위의 포맷터가 만드는 것과 정확히 같은 4칸 들여쓰기의 표준 스타일입니다. 스타일을 다음으로 바꿔 보세요 컴팩트 로 바꾸면 더 조밀한 SQL이 되고, 확장 로 바꾸면 쉼표를 줄 앞에 두고 한 줄에 한 항목씩 배치합니다. 다음은 포매터 문서 세부 내용을 다룹니다.

PostgreSQL 포맷터 FAQ

PostgreSQL 포매터가 ->> 또는 @> 같은 JSONB 연산자를 깨뜨리나요?

아니요. PostgreSQL과 마찬가지로 연산자를 연속된 연산자 문자로 읽기 때문에 ->>, #>>, @>, <@, ?| 및 사용자 정의 연산자는 절대 분리되지 않습니다. 출력이 원래와 같은 SQL로 토큰화되지 않으면 입력을 그대로 반환합니다.

함수의 $$ 따옴표 사이 본문을 다시 포맷하나요?

아니요. 달러 인용된 본문은 문자열 리터럴이고 포맷터는 문자열 내부를 절대 바꾸지 않습니다. 바깥의 CREATE FUNCTION 문은 여전히 정렬됩니다.

"MixedCase" 이름에서 따옴표를 제거하나요?

사용자가 요청한 경우에만, 그리고 안전할 때만 제거합니다. PostgreSQL은 따옴표 없는 이름을 소문자로 변환하므로, '불필요한 따옴표 제거'는 이미 소문자이고 키워드가 아닌 이름만 따옴표를 제거합니다.

내 SQL이 서버로 전송되나요?

아니요. 포맷터는 WebAssembly로 컴파일되어 브라우저 탭 안에서 실행됩니다. SQL은 절대 업로드되거나 기록되거나 저장되지 않으며, 페이지가 한 번 로드되면 오프라인에서도 계속 동작합니다.

포맷이 내 쿼리를 망칠 수 있나요?

그럴 수 없도록 만들어져 있습니다. 형식 지정을 한 후, SQLly는 출력 결과를 입력과 토큰 단위로 비교합니다. 공백과 요청한 대소문자를 제외하고 어떤 것도 변경된다면, SQLly는 작성한 그대로 SQL을 다시 돌려주며 이유를 알려줍니다. 종료되지 않은 문자열 같은 제대로 구문 분석되지 않는 SQL도 그대로 남아 있으며, 문제의 줄과 열 위치를 알려줍니다.

내 포맷 설정을 팀과 공유할 수 있나요?

네. 고급 설정을 포함한 모든 설정이 # 뒤 페이지 주소에 저장되므로 주소를 복사하거나 설정 링크 복사 버튼을 누르면 정확한 스타일이 그대로 공유됩니다. 링크에는 설정만 담기고 SQL은 담기지 않습니다.

// 포맷팅은 그중 가장 작은 부분입니다

포맷터가 마음에 드시나요? SQLly의 나머지 기능들도 만나보세요

스키마를 아는 IntelliSense, 위험한 쿼리 가드레일, 그리고 에디터에 내장된 바로 이 포매터를 갖춘 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다.