Formatowanie SQL online

Jak sformatować zapytanie SQL

1. Wklej jedno lub kilka zapytań albo kliknij Otwórz plik, aby wczytać plik .sql (do 10 MB).
2. Wybierz Dialekt swojej bazy danych, np. PostgreSQL, MySQL lub SQL Server (T-SQL).
3. Zdecyduj, jak zapisywać Słowa kluczowe (WIELKIE LITERY, małe litery lub Bez zmian), i ustaw Wcięcie.
4. Zaznacz Bez spacji wokół operatorów, jeśli wolisz a=b+1 zamiast a = b + 1.
5. Kliknij Formatuj SQL, a potem skopiuj lub pobierz wynik. Zmiana dowolnej opcji formatuje zapytanie ponownie.

Zapytanie jest jedynie przeformatowywane jako tekst. Nigdy nie jest wykonywane ani wysyłane do bazy danych czy na serwer.

Co robi formatter

Narzędzie korzysta z otwartoźródłowej biblioteki sql-formatter. Dzieli każdą instrukcję na klauzule i umieszcza każde słowo kluczowe klauzuli (SELECT, FROM, WHERE, GROUP BY, ORDER BY…) w osobnej linii, a jej zawartość wcina poniżej. Kolumny z listy SELECT trafiają po jednej do linii, warunki AND i OR zaczynają nowe linie, a podzapytania i wyrażenia CASE są wcinane według poziomu zagnieżdżenia. Krótkie wyrażenia w nawiasach zostają w jednej linii. Kilka instrukcji rozdzielonych średnikami oddziela pusta linia.

Zmieniają się wyłącznie białe znaki i wielkość liter. Literały tekstowe, identyfikatory w cudzysłowach i komentarze zostają nietknięte, więc sformatowane zapytanie zwraca ten sam wynik co oryginał – także wtedy, gdy w tekstach są polskie znaki.

Dlaczego dialekt ma znaczenie

Bazy SQL mają wspólny rdzeń języka, ale różnią się szczegółami, a formatter musi je znać, aby poprawnie odczytać zapytanie:

• identyfikatory ujmuje się w "cudzysłowy" w standardowym SQL i PostgreSQL, w `grawisy` w MySQL, MariaDB i BigQuery, a w [nawiasy kwadratowe] w SQL Server;
• operatory takie jak ->> i rzutowanie :: w PostgreSQL czy dostęp do ścieżki : w Snowflake istnieją tylko w niektórych dialektach;
• znaczniki parametrów są różne: ?, $1, :name lub @name;
• każdy dialekt ma własne słowa zastrzeżone i funkcje, na które działa opcja Słowa kluczowe.

Jeśli widzisz komunikat, że nie udało się przeanalizować zapytania, najpierw sprawdź, czy wybrany dialekt odpowiada twojej bazie. Błąd podaje linię i kolumnę, w której analiza się zatrzymała. Standardowy SQL to wybór najbardziej restrykcyjny – jeśli tylko możesz, wybierz swoją faktyczną bazę danych.

Wielkość liter słów kluczowych i dobre praktyki

Wielkie litery w słowach kluczowych to wciąż najpopularniejsza konwencja, bo od razu oddzielają język od nazw tabel i kolumn. Małe litery są popularne w zespołach, którym łatwiej się je czyta, a Bez zmian zostawia twój wybór nietknięty. Nazwy tabel, kolumn i funkcji nigdy nie są zmieniane: opcji podlegają tylko zastrzeżone słowa kluczowe. W długich plikach spójne formatowanie bardzo ułatwia też przeglądanie różnic między wersjami.