Formátování SQL

Jak naformátovat dotaz SQL

1. Vlož jeden či více dotazů, nebo klikni na Otevřít soubor a načti soubor .sql (do 10 MB).
2. Vyber Dialekt své databáze, například PostgreSQL, MySQL nebo SQL Server (T-SQL).
3. Zvol, jak psát Klíčová slova (VELKÁ PÍSMENA, malá písmena nebo Ponechat beze změny), a Odsazení.
4. Zaškrtni Bez mezer kolem operátorů, pokud dáváš přednost a=b+1 před a = b + 1.
5. Klikni na Formátovat SQL, pak výsledek zkopíruj nebo stáhni. Změna volby dotaz znovu naformátuje.

Dotaz se jen přeformátuje jako text. Nikdy se nespouští a neodesílá se do databáze ani na server.

Co formátovač dělá

Nástroj používá open-source knihovnu sql-formatter. Každý příkaz rozdělí na klauzule a klíčové slovo každé klauzule (SELECT, FROM, WHERE, GROUP BY, ORDER BY…) umístí na vlastní řádek, přičemž obsah klauzule odsadí pod něj. Sloupce v seznamu SELECT se dávají po jednom na řádek, podmínky AND a OR začínají nový řádek a poddotazy i výrazy CASE se odsazují podle úrovně vnoření. Krátké výrazy v závorkách zůstávají na jednom řádku. Několik příkazů oddělených středníky se od sebe odděluje prázdným řádkem.

Mění se jen mezery a velikost písmen. Řetězcové literály, uvozené identifikátory a komentáře zůstávají přesně zachovány, takže naformátovaný dotaz vrací stejný výsledek jako původní.

Proč na dialektu záleží

Databáze SQL sdílejí jádro jazyka, ale liší se v detailech, které formátovač musí znát, aby dotaz správně přečetl:

• identifikátory se uvozují "dvojitými uvozovkami" ve standardním SQL a PostgreSQL, `zpětnými apostrofy` v MySQL, MariaDB a BigQuery a [hranatými závorkami] v SQL Serveru;
• operátory jako ->> a přetypování :: v PostgreSQL nebo přístup k cestě : ve Snowflake existují jen v některých dialektech;
• zástupné symboly parametrů se liší: ?, $1, :name nebo @name;
• každý dialekt má vlastní rezervovaná slova a funkce, které volba Klíčová slova mění.

Pokud dostaneš hlášku „Dotaz se nepodařilo zpracovat“, nejdřív zkontroluj, zda zvolený dialekt odpovídá tvé databázi. Chyba ukáže řádek a sloupec, kde zpracování skončilo. Standardní SQL je nejpřísnější volba; kdykoli to jde, vyber svou skutečnou databázi.

Velikost klíčových slov a tipy ke stylu

Velká písmena klíčových slov zůstávají nejběžnější konvencí, protože na první pohled oddělují jazyk od názvů tabulek a sloupců. Malá písmena jsou oblíbená v týmech, kterým se lépe čtou, a Ponechat beze změny tvoji volbu nechá nedotčenou. Názvy tabulek, sloupců a funkcí se nikdy nemění: volbu sledují jen rezervovaná klíčová slova. U dlouhých souborů také jednotné formátování výrazně usnadňuje kontrolu rozdílů mezi verzemi.