Русский
Красиво оформляйте SQL-запросы с умными отступами.
Последнее обновление
SQL-форматтер берёт плотный, однострочный или сгенерированный ORM-ом SQL и переписывает его с понятными отступами и переносами строк. Разработчики и аналитики обращаются к нему, когда разбирают джойны, ловят баги в фильтрах, причёсывают вывод ORM, прикладывают запросы к тикетам и документации или разбирают план выполнения.
Форматирование не меняет *того, что делает* запрос — оно меняет лишь то, насколько легко его прочитать человеку. Когда раскладка единообразная, связь между SELECT, FROM, JOIN, WHERE, GROUP BY, HAVING и ORDER BY становится гораздо нагляднее, особенно в запросах с подзапросами и CTE.
У SQL много *диалектов*: PostgreSQL, MySQL, SQLite, T-SQL (Microsoft SQL Server), Oracle, BigQuery — каждый расширяет стандарт собственным синтаксисом. Хороший форматтер понимает выбранный диалект и не ломает специфичные для СУБД конструкции.
SELECT выбирает столбцы, FROM — таблицы, WHERE фильтрует строки, GROUP BY агрегирует, ORDER BY сортирует.RETURNING, LIMIT, TOP и идентификаторы в кавычках/скобках ([col] против "col") между СУБД не переносимы.Закиньте SQL в поле ввода. Подойдёт однострочный, сгенерированный ORM-ом или частично оформленный код.
Укажите PostgreSQL, MySQL, SQLite или T-SQL — тогда форматтер корректно обработает специфичные ключевые слова вроде LIMIT, TOP или RETURNING.
Выберите регистр ключевых слов (стандарт — UPPERCASE) и ширину отступа (2 или 4 пробела). Большинство команд берут UPPERCASE + 2 пробела.
Каждая клауза — на своей строке, джойны выровнены, подзапросы с отступом. Комментарии сохраняются.
Вставьте отформатированный запрос в миграцию, raw-запрос ORM или BI-инструмент. Всё происходит в браузере.
Клаузы, которые встречаются в 95% SELECT-запросов, в порядке их концептуальной обработки. Ссылки на доки: PostgreSQL SELECT, MySQL SELECT.
| Клауза | Назначение | Пример |
|---|---|---|
SELECT | Какие столбцы или выражения вернуть | SELECT id, name |
FROM | Из какой таблицы (или таблиц) брать данные | FROM users |
JOIN ... ON | Соединить строки с другой таблицей | JOIN orders ON orders.user_id = users.id |
WHERE | Фильтрация строк до группировки | WHERE active = true |
GROUP BY | Группировка строк с одинаковыми значениями | GROUP BY country |
HAVING | Фильтрация уже сгруппированных данных | HAVING COUNT(*) > 10 |
ORDER BY | Сортировка результата | ORDER BY created_at DESC |
LIMIT / OFFSET | Пагинация результата | LIMIT 20 OFFSET 40 |
WITH ... AS | Common Table Expression (CTE) — именованный подзапрос | WITH active AS (...) |
select id,name from users where active=true order by created_at desc limit 10SELECT id, nameFROM usersWHERE active = trueORDER BY created_at DESCLIMIT 10;Теперь каждая клауза — на своей строке, а список столбцов с отступом. Code review такого запроса станет в 10 раз приятнее.
select u.name,o.total from users u join orders o on o.user_id=u.id where o.total>100SELECT u.name, o.totalFROM users uJOIN orders o ON o.user_id = u.idWHERE o.total > 100;Алиасы таблиц (users u, orders o) делают список столбцов короче. Строка JOIN ... ON явно показывает связь между таблицами.
select * from users where id in (select user_id from enrollments where course_id=5)SELECT *FROM usersWHERE id IN ( SELECT user_id FROM enrollments WHERE course_id = 5);Отступ внутреннего запроса наглядно показывает зависимость. Когда структура видна, многие подзапросы легко переписать через JOIN или CTE.
LIMIT 10 в PostgreSQL, TOP 10 в T-SQL и FETCH FIRST 10 ROWS ONLY в стандартном SQL делают одно и то же.SELECT, FROM, WHERE) — заглавными, идентификаторы — строчными. Контраст помогает увидеть структуру запроса. Главное — выбрать стиль и придерживаться его.