Formater SQL

Wklej zapytanie SQL i odbierz je z powrotem z wcięciami i podziałem na linie, ze słowami kluczowymi takimi jak SELECT, FROM czy WHERE w osobnych liniach i spójną wielkością liter. Wybierz dialekt, żeby składnia charakterystyczna dla danej bazy była formatowana poprawnie, oraz ustaw wielkość liter słów kluczowych i szerokość wcięcia zgodnie ze stylem swojego zespołu.

Jakie dialekty SQL są obsługiwane?

Można formatować standardowy SQL, MySQL, PostgreSQL, SQLite, T-SQL (SQL Server) albo BigQuery. Każdy dialekt ma swoje osobliwości, na przykład identyfikatory w cudzysłowach wstecznych w MySQL albo składnię tablic i struktur w BigQuery, więc wybór właściwego dialektu sprawia, że formater poprawnie je rozpoznaje zamiast gubić się na składni, której standardowy SQL nie zna. Jeśli nie wiesz, do jakiego dialektu należy zapytanie, standardowy SQL jest bezpiecznym wyborem dla wszystkiego, co nie korzysta z funkcji specyficznych dla konkretnego dostawcy.

Poza dialektem można ustawić wielkość liter słów kluczowych na wielkie, małe albo pozostawić tak, jak zostały wpisane, a wcięcie na dwie spacje, cztery spacje albo tabulator. Ustawienie wielkich liter dla zapytania napisanego małymi literami sprawi na przykład, że każde SELECT, JOIN i GROUP BY zostanie zapisane wielkimi literami, bez zmieniania nazw kolumn czy tabel.

Czy zapytanie kiedykolwiek opuszcza moją przeglądarkę?

Nie. Formatowanie odbywa się w całości po stronie klienta, przy użyciu biblioteki sql-formatter, która działa w JavaScript i nie wykonuje żadnych żądań sieciowych. Nic z tego, co wklejasz, nie jest wysyłane na serwer, logowane ani zapisywane, więc można bez obaw formatować zapytanie zawierające prawdziwe nazwy tabel, dane klientów albo inne osadzone wartości, których nie chciałbyś wklejać do przypadkowego formularza w sieci.

Co jeśli formater nie potrafi sparsować mojego zapytania?

Jeśli SQL nie da się sparsować w wybranym dialekcie, narzędzie pokazuje błąd zamiast zgadywać częściowy wynik. Zwykle oznacza to, że wybrano niewłaściwy dialekt, w zapytaniu jest rzeczywisty błąd składni, albo zapytanie korzysta z funkcji, której parser nie rozpoznaje (niektóre rozszerzenia specyficzne dla konkretnej bazy danych albo nietypowe style komentarzy potrafią mu w tym przeszkodzić). Zmiana dialektu albo sprawdzenie, czy w okolicy zgłoszonego miejsca nie ma zbędnego przecinka albo niedomkniętego nawiasu, zwykle wystarcza, żeby to naprawić.

Kiedy się to przydaje?

Typowe zastosowania: uporządkowanie jednolinijkowego zapytania skopiowanego z logu debugowania ORM-a, ujednolicenie formatowania przed code review, albo zamiana zminifikowanego skryptu migracji na coś czytelnego. Konwencje stylistyczne wykraczające poza to, co da się poprawić samym formatowaniem, na przykład nazewnictwo i komentarze, opisuje SQL Style Guide.