// бесплатный инструмент

Форматтер SQL для BigQuery

Форматируйте GoogleSQL для BigQuery прямо в браузере. Пути таблиц в обратных кавычках, параметры запроса, массивы и QUALIFY сохраняются как есть и аккуратно раскладываются.

Форматтер читает SQL BigQuery с использованием правил MySQL, а также синтаксиса BigQuery, указанного ниже.

Перетащите сюда файл .sql, чтобы открыть его. Он читается в вашем браузере, а не загружается.

Отформатированный 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, который знает вашу схему, предохранителями для рискованных запросов и этим форматировщиком, встроенным прямо в редактор.