Formatter SQL

Co robi to narzędzie

Formatter SQL zamienia długie, jednoliniowe zapytanie w czytelne zapytanie ze spójnymi wcięciami. Każda klauzula (SELECT, FROM, WHERE, GROUP BY, ORDER BY) zaczyna się w nowej linii, wybrane kolumny i warunki są wypisane po jednym na linię, złączenia (JOIN) są wyrównane pod tabelą, do której się odnoszą, a podzapytania mają wcięcie wewnątrz nawiasów.

Sformatowany SQL łatwiej przejrzeć w pull requestach, łatwiej debugować, gdy zapytanie zwraca niewłaściwe wiersze, i łatwiej wkleić do dokumentacji. Pomaga też, gdy kopiujesz zapytanie z logu ORM-a albo z komunikatu błędu aplikacji, gdzie wszystko jest w jednej linii.

Jak używać

1. Wklej jedno lub więcej poleceń SQL w polu Wejście, upuść na nie plik .sql albo kliknij Przykład.
2. Wybierz Dialekt swojej bazy danych.
3. Wybierz, czy Słowa kluczowe mają być WIELKIMI LITERAMI, małymi literami, czy bez zmian. Nazwy funkcji, takie jak COUNT, stosują się do tego samego ustawienia.
4. Wybierz 2 spacje, 4 spacje lub tabulatory jako Wcięcie.
5. Skopiuj wynik lub pobierz go jako plik .sql. Skróty: Ctrl/Cmd+Enter formatuje, Ctrl/Cmd+Shift+C kopiuje.

Kilka poleceń rozdzielonych średnikami zostaje oddzielonych pustą linią. Komentarze zostają na swoich miejscach.

Przykład

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

zmienia się w

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

Wskazówki

Słowa kluczowe pisane wielkimi literami odróżniają klauzule od nazw tabel i kolumn — to najpopularniejsza konwencja w zespołach. Jeśli twój zespół pisze SQL małymi literami, wybierz małe litery, a całe zapytanie będzie spójne. Jeśli formatter zgłasza nieoczekiwany token, sprawdź, czy dialekt jest właściwy: na przykład nazwy w backtickach są poprawne w MySQL, ale nie w standardowym SQL.