Форматирование SQL

Что делает инструмент

Форматтер SQL превращает длинный однострочный запрос в читаемый, с единообразными отступами. Каждое предложение (SELECT, FROM, WHERE, GROUP BY, ORDER BY) начинается с новой строки, выбираемые столбцы и условия перечисляются по одному на строку, соединения выравниваются под таблицей, к которой они присоединяются, а подзапросы получают отступ внутри своих скобок.

Отформатированный SQL проще проверять в pull request, отлаживать, когда запрос возвращает не те строки, и вставлять в документацию. Это помогает и тогда, когда вы копируете запрос из лога ORM или сообщения об ошибке приложения, где всё записано в одну строку.

Как пользоваться

1. Вставьте одну или несколько SQL-инструкций в поле Ввод, перетащите на него файл .sql или нажмите Пример.
2. Выберите Диалект своей базы данных.
3. Выберите, как писать Ключевые слова: в ВЕРХНЕМ РЕГИСТРЕ, в нижнем регистре или как написано. Имена функций, например COUNT, следуют той же настройке.
4. Выберите Отступ: 2 пробела, 4 пробела или табуляция.
5. Скопируйте результат или скачайте его как файл .sql. Горячие клавиши: Ctrl/Cmd+Enter — форматировать, Ctrl/Cmd+Shift+C — копировать.

Несколько инструкций, разделённых точкой с запятой, отделяются друг от друга пустой строкой. Комментарии остаются на своих местах.

Пример

select u.id, count(o.id) as orders from users u left join orders o on o.user_id = u.id group by u.id

превращается в

SELECT
  u.id,
  COUNT(o.id) AS orders
FROM
  users u
  LEFT JOIN orders o ON o.user_id = u.id
GROUP BY
  u.id

Советы

Ключевые слова в верхнем регистре выделяют предложения на фоне имён таблиц и столбцов — это самое распространённое соглашение в командах. Если ваша команда пишет SQL строчными буквами, выберите нижний регистр, и весь запрос будет оформлен так же. Если форматтер сообщает о неожиданном токене, проверьте, правильно ли выбран диалект: например, имена в обратных кавычках допустимы в MySQL, но не в стандартном SQL.