Форматировщик PostgreSQL
Форматируйте PostgreSQL прямо в браузере. Приведения типов, тела в долларовых кавычках, JSONB-операторы и массивы читаются так, как их читает Postgres, поэтому форматтер меняет только пробелы и указанный вами регистр.
Все настройки компоновки форматтера, сгруппированные так же, как Редактор › Форматирование в приложении SQLly. Стиль выше — отправная точка; всё, что вы здесь измените, будет помечено.
Перетащите сюда файл .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.
Другие диалекты
- Любой диалект (автоопределение)
- Форматировщик SQL Server (T-SQL)
- Форматтер MySQL
- Форматтер SQLite
- Форматировщик Oracle SQL
- Форматировщик SQL для Snowflake
- Форматтер SQL для BigQuery
- Форматировщик SQL для Redshift
Работаете с PostgreSQL каждый день? Посмотрите, что настольное приложение SQLly делает для PostgreSQL, или просмотрите все возможности.
Нравится форматировщик? Познакомьтесь с остальными возможностями SQLly
Нативная рабочая среда SQL для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и этим форматировщиком, встроенным прямо в редактор.