BigQuery SQL 포매터
브라우저에서 BigQuery용 GoogleSQL을 포맷하세요. 백틱 테이블 경로, 쿼리 파라미터, 배열 및 QUALIFY를 그대로 유지하며 깔끔하게 정리됩니다.
포매터는 BigQuery SQL을 MySQL 규칙으로 읽으며, 아래에 나열한 BigQuery 구문도 지원합니다.
포매터의 모든 레이아웃 설정을 다음처럼 묶어 놓았습니다 편집기 › 서식 SQLly 앱에서 말입니다. 위의 스타일이 시작점이고, 여기서 바꾸는 것은 모두 표시됩니다.
여기에 .sql 파일을 드롭하면 열 수 있습니다. 파일은 업로드되지 않고 브라우저에서 읽힙니다.
SELECT
user_id,
COUNT(*) AS sessions,
ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
`my-project.analytics.events`
WHERE
event_name = @event
AND 'beta' IN UNNEST(tags)
AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
user_id
QUALIFY
ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100
Loading the formatter…
편집기 단축키: Ctrl+엔터 형식 및 Ctrl+Shift+엔터 축소(⌘ 다음 대신 Ctrl 사용). 이 브라우저에서 설정이 저장되고 페이지 주소에 유지되므로 링크를 공유하면 스타일만 공유되며 SQL은 공유되지 않습니다.
포맷터가 BigQuery SQL을 처리하는 방식
- 백틱 테이블 경로.
`my-project.analytics.events`은(는) 하이픈까지 포함해 따옴표로 묶인 이름 하나입니다. - 쿼리 매개변수.
@event명명된 매개변수는 단일 토큰으로 읽힙니다. - 배열은 작성한 대로 유지됩니다.
[1, 2, 3]리터럴과arr[OFFSET(0)]첨자는 입력한 대로 정확히 유지되며,UNNEST,STRUCT그리고ARRAY_AGG호출은 다른 함수와 마찬가지로 배치됩니다. - QUALIFY에는 전용 절이 있습니다, 이렇게 배치됩니다
HAVING, 그리고INTERVAL그리고OVER (PARTITION BY …)키워드 대소문자를 유지합니다. - 주석과 문자열.
#주석은 유지되고, 큰따옴표로 묶인 텍스트는 문자열이며,r'…'raw 및b'…'bytes 리터럴은 접두사에 붙은 채로 유지됩니다.
알아 두면 좋은 정보
- 키워드 대소문자 적용은 표준 SQL 및 MySQL 키워드를 포함하므로, 일부 BigQuery 전용 단어는 입력한 대로 대소문자를 유지합니다.
예시
BigQuery 사용 전후
select user_id, count(*) as sessions, array_agg(page order by ts limit 5) as first_pages from `my-project.analytics.events` where event_name = @event and 'beta' in unnest(tags) and ts >= timestamp_sub(current_timestamp(), interval 7 day) group by user_id qualify row_number() over (order by count(*) desc) <= 100
SELECT
user_id,
COUNT(*) AS sessions,
ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
`my-project.analytics.events`
WHERE
event_name = @event
AND 'beta' IN UNNEST(tags)
AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
user_id
QUALIFY
ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100
출력은 위의 포맷터가 만드는 것과 정확히 같은 4칸 들여쓰기의 표준 스타일입니다. 스타일을 다음으로 바꿔 보세요 컴팩트 로 바꾸면 더 조밀한 SQL이 되고, 확장 로 바꾸면 쉼표를 줄 앞에 두고 한 줄에 한 항목씩 배치합니다. 다음은 포매터 문서 세부 내용을 다룹니다.
BigQuery 포매터 FAQ
포매터는 BigQuery SQL을 어떻게 읽나요?
MySQL 규칙을 기반으로 합니다. 백틱 인용, # 주석, 큰따옴표 문자열은 BigQuery와 같고, 게다가 @parameters, [ ] 배열, QUALIFY도 이해합니다.
백틱 project.dataset.table 이름이 깨지나요?
아니요. 백틱(`)으로 감싼 경로는 포맷터가 하나의 이름으로 취급하므로 작성된 그대로 유지됩니다.
내 SQL이 서버로 전송되나요?
아니요. 포맷터는 WebAssembly로 컴파일되어 브라우저 탭 안에서 실행됩니다. SQL은 절대 업로드되거나 기록되거나 저장되지 않으며, 페이지가 한 번 로드되면 오프라인에서도 계속 동작합니다.
포맷이 내 쿼리를 망칠 수 있나요?
그럴 수 없도록 만들어져 있습니다. 형식 지정을 한 후, SQLly는 출력 결과를 입력과 토큰 단위로 비교합니다. 공백과 요청한 대소문자를 제외하고 어떤 것도 변경된다면, SQLly는 작성한 그대로 SQL을 다시 돌려주며 이유를 알려줍니다. 종료되지 않은 문자열 같은 제대로 구문 분석되지 않는 SQL도 그대로 남아 있으며, 문제의 줄과 열 위치를 알려줍니다.
내 포맷 설정을 팀과 공유할 수 있나요?
네. 고급 설정을 포함한 모든 설정이 # 뒤 페이지 주소에 저장되므로 주소를 복사하거나 설정 링크 복사 버튼을 누르면 정확한 스타일이 그대로 공유됩니다. 링크에는 설정만 담기고 SQL은 담기지 않습니다.
포맷터가 마음에 드시나요? SQLly의 나머지 기능들도 만나보세요
스키마를 아는 IntelliSense, 위험한 쿼리 가드레일, 그리고 에디터에 내장된 바로 이 포매터를 갖춘 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다.