Форматтер SQL для BigQuery
Форматируйте GoogleSQL для BigQuery прямо в браузере. Пути таблиц в обратных кавычках, параметры запроса, массивы и QUALIFY сохраняются как есть и аккуратно раскладываются.
Форматтер читает SQL BigQuery с использованием правил 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+Enter форматы и Ctrl+Shift+Enter минифицирует (⌘ вместо Ctrl на Mac). Настройки запоминаются в этом браузере и хранятся в адресе страницы, поэтому ссылка делится вашим стилем – но не вашим SQL.
Что делает форматировщик с диалектом BigQuery
- Пути к таблицам в обратных кавычках.
`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
Результат оформлен в стиле Standard с отступами в 4 пробела — ровно как его выдаёт форматтер выше. Переключите стиль на Компактный для более компактного SQL или Развёрнутый для ведущих запятых и одного элемента на строку. Этот документация по форматированию описывают детали.
FAQ по форматтеру BigQuery
Как форматировщик читает SQL BigQuery?
С правилами MySQL, у которых те же обратные кавычки, что и в BigQuery, комментарии # и строки в двойных кавычках. Помимо этого, он понимает @параметры, массивы [ ] и QUALIFY.
Сломает ли это имена в обратных кавычках вида project.dataset.table?
Нет. Форматтер считает путь в обратных кавычках одним именем и сохраняет его в точности как написано.
Отправляется ли мой SQL на сервер?
Нет. Форматтер скомпилирован в WebAssembly и работает прямо в вашей вкладке браузера. Ваш SQL никуда не отправляется, не логируется и не хранится, а после загрузки страницы форматтер работает и офлайн.
Может ли форматирование повредить мой запрос?
Оно создано так, чтобы не делать этого. После форматирования SQLly сверяет свой результат с вашим вводом токен за токеном. Если бы изменилось что-то, кроме пробелов и выбранного вами регистра, SQLly вернул бы ваш SQL ровно в том виде, в каком вы его написали, и объяснил бы почему. SQL, который не разбирается корректно, например с незакрытой строкой, тоже остаётся нетронутым — с указанием строки и столбца проблемы.
Могу ли я поделиться настройками форматирования с командой?
Да. Каждая настройка, включая расширенные, сохраняется в адресе страницы после знака #, так что копирование адреса или нажатие на «Скопировать ссылку с настройками» позволяет поделиться вашим точным стилем. Ссылка содержит только настройки, никогда — ваш SQL.
Нравится форматировщик? Познакомьтесь с остальными возможностями SQLly
Нативная рабочая среда SQL для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и этим форматировщиком, встроенным прямо в редактор.