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

Форматировщик 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+Enter форматы и Ctrl+Shift+Enter минифицирует (⌘ вместо Ctrl на Mac). Настройки запоминаются в этом браузере и хранятся в адресе страницы, поэтому ссылка делится вашим стилем – но не вашим SQL.

Что делает форматировщик с диалектом PostgreSQL

  • Операторы читаются так же, как их читает 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&'…' Каждая строка Unicode — один токен.
  • Кавычки с учетом регистра. 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;

Результат оформлен в стиле Standard с отступами в 4 пробела — ровно как его выдаёт форматтер выше. Переключите стиль на Компактный для более компактного SQL или Развёрнутый для ведущих запятых и одного элемента на строку. Этот документация по форматированию описывают детали.

Часто задаваемые вопросы по форматировщику PostgreSQL

Ломает ли форматтер PostgreSQL операторы JSONB вроде ->> или @>?

Нет. Операторы он читает, как PostgreSQL, — одним непрерывным блоком символов, поэтому ->>, #>>, @>, <@, ?| и пользовательские операторы никогда не разбиваются. Если вывод не совпал бы по лексике с исходным SQL, ваш ввод возвращается без изменений.

Переформатирует ли он тело функции в $$-кавычках?

Нет. Тело в долларовых кавычках — это строковый литерал, и форматтер никогда не меняет то, что внутри строки. Инструкция CREATE FUNCTION вокруг него при этом форматируется.

Удалит ли это кавычки у имён вида "MixedCase"?

Только если вы попросите, и только когда это безопасно. PostgreSQL приводит имена без кавычек к нижнему регистру, поэтому «Удалять ненужные кавычки» снимает кавычки только с имён, которые уже в нижнем регистре и не являются ключевыми словами.

Отправляется ли мой SQL на сервер?

Нет. Форматтер скомпилирован в WebAssembly и работает прямо в вашей вкладке браузера. Ваш SQL никуда не отправляется, не логируется и не хранится, а после загрузки страницы форматтер работает и офлайн.

Может ли форматирование повредить мой запрос?

Оно создано так, чтобы не делать этого. После форматирования SQLly сверяет свой результат с вашим вводом токен за токеном. Если бы изменилось что-то, кроме пробелов и выбранного вами регистра, SQLly вернул бы ваш SQL ровно в том виде, в каком вы его написали, и объяснил бы почему. SQL, который не разбирается корректно, например с незакрытой строкой, тоже остаётся нетронутым — с указанием строки и столбца проблемы.

Могу ли я поделиться настройками форматирования с командой?

Да. Каждая настройка, включая расширенные, сохраняется в адресе страницы после знака #, так что копирование адреса или нажатие на «Скопировать ссылку с настройками» позволяет поделиться вашим точным стилем. Ссылка содержит только настройки, никогда — ваш SQL.

// форматирование — далеко не главное

Нравится форматировщик? Познакомьтесь с остальными возможностями SQLly

Нативная рабочая среда SQL для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и этим форматировщиком, встроенным прямо в редактор.