SQL-formaterare

Så formaterar du en SQL-fråga

1. Klistra in en eller flera frågor, eller klicka på Öppna en fil för att läsa in en .sql-fil (upp till 10 MB).
2. Välj Dialekt för din databas, till exempel PostgreSQL, MySQL eller SQL Server (T-SQL).
3. Välj hur Nyckelord ska skrivas (VERSALER, gemener eller Behåll som skrivet) och vilket Indrag du vill ha.
4. Kryssa i Inga mellanslag runt operatorer om du föredrar a=b+1 framför a = b + 1.
5. Klicka på Formatera SQL och kopiera eller ladda ner resultatet. Ändrar du ett alternativ formateras frågan om.

Frågan formateras bara om som text. Den körs aldrig och skickas aldrig till någon databas eller server.

Vad formateraren gör

Verktyget använder biblioteket sql-formatter, som har öppen källkod. Det delar upp varje sats i satsdelar och placerar varje nyckelord för en satsdel (SELECT, FROM, WHERE, GROUP BY, ORDER BY …) på en egen rad, med satsdelens innehåll indraget under. Kolumnerna i en SELECT-lista hamnar en per rad, villkor med AND och OR börjar på nya rader, och underfrågor och CASE-uttryck dras in efter nästlingsnivå. Korta uttryck inom parentes stannar på en rad. Flera satser åtskilda av semikolon hålls isär med en tom rad.

Bara blanktecken och skiftläge ändras. Strängliteraler, citerade identifierare och kommentarer behålls exakt, så den formaterade frågan ger samma resultat som originalet. Text som 'Åsa Öberg' i en sträng rörs alltså inte.

Därför spelar dialekten roll

SQL-databaser delar kärnspråket men skiljer sig i detaljerna, och en formaterare måste känna till dem för att läsa frågan rätt:

• identifierare citeras med "dubbla citattecken" i standard-SQL och PostgreSQL, med `backticks` i MySQL, MariaDB och BigQuery och med [hakparenteser] i SQL Server;
• operatorer som PostgreSQL:s ->> och ::-konverteringar, eller Snowflakes sökvägsåtkomst med :, finns bara i vissa dialekter;
• platshållare för parametrar skiljer sig: ?, $1, :name eller @name;
• varje dialekt har sina egna reserverade ord och funktioner, och det är dem som alternativet Nyckelord ändrar.

Får du meddelandet ”Frågan kunde inte tolkas” ska du först kontrollera att den valda dialekten stämmer med din databas. Felet visar raden och kolumnen där tolkningen stannade. Standard-SQL är det mest restriktiva valet, så välj din faktiska databas när det går.

Skiftläge för nyckelord och stiltips

Nyckelord med versaler är fortfarande den vanligaste konventionen, eftersom de skiljer språket från tabell- och kolumnnamn med en gång. Gemener är populärt i team som tycker att det är lättare att läsa, och Behåll som skrivet låter ditt val vara orört. Tabell-, kolumn- och funktionsnamn ändras aldrig: bara reserverade nyckelord följer alternativet. I långa filer gör en konsekvent formatering det också mycket lättare att granska skillnader mellan versioner.