SQL-formaterer

Slik formaterer du en SQL-spørring

1. Lim inn én eller flere spørringer, eller klikk Åpne fil for å laste inn en .sql-fil (opptil 10 MB).
2. Velg Dialekt for databasen din, for eksempel PostgreSQL, MySQL eller SQL Server (T-SQL).
3. Velg hvordan Nøkkelord skal skrives (STORE BOKSTAVER, små bokstaver eller Behold som skrevet) og Innrykk.
4. Huk av for Ingen mellomrom rundt operatorer hvis du foretrekker a=b+1 framfor a = b + 1.
5. Klikk Formater SQL, og kopier eller last ned resultatet. Når du endrer et valg, formateres spørringen på nytt.

Spørringen formateres bare som tekst. Den kjøres aldri og sendes aldri til en database eller en server.

Hva formatereren gjør

Verktøyet bruker det åpne biblioteket sql-formatter. Det deler hver setning i klausuler og setter hvert klausulnøkkelord (SELECT, FROM, WHERE, GROUP BY, ORDER BY …) på sin egen linje, med innholdet i klausulen rykket inn under. Kolonner i en SELECT-liste settes én per linje, AND- og OR-vilkår begynner på nye linjer, og underspørringer og CASE-uttrykk rykkes inn etter nestingsnivå. Korte uttrykk i parentes blir stående på én linje. Flere setninger atskilt med semikolon holdes fra hverandre med en blank linje.

Bare mellomrom og store/små bokstaver endres. Strengliteraler, siterte identifikatorer og kommentarer beholdes nøyaktig, så den formaterte spørringen gir samme resultat som originalen.

Hvorfor dialekten har betydning

SQL-databaser deler kjernespråket, men er ulike i detaljene, og en formaterer må kjenne dem for å lese spørringen riktig:

• identifikatorer siteres med "doble anførselstegn" i standard-SQL og PostgreSQL, med `backticks` i MySQL, MariaDB og BigQuery, og med [hakeparenteser] i SQL Server
• operatorer som PostgreSQLs ->> og ::-typekonvertering, eller Snowflakes sti-tilgang med :, finnes bare i noen dialekter
• plassholdere for parametere varierer: ?, $1, :name eller @name
• hver dialekt har sine egne reserverte ord og funksjoner, som valget Nøkkelord endrer.

Får du «Spørringen kunne ikke tolkes», sjekker du først at den valgte dialekten stemmer med databasen din. Feilmeldingen viser linjen og kolonnen der tolkingen stoppet. Standard-SQL er det mest restriktive valget: velg den faktiske databasen din når det er mulig.

Store og små bokstaver og stiltips

Nøkkelord med store bokstaver er fortsatt den vanligste konvensjonen, fordi de skiller språket fra tabell- og kolonnenavn med et blikk. Små bokstaver er populære i team som synes det er lettere å lese, og Behold som skrevet lar ditt eget valg stå urørt. Navn på tabeller, kolonner og funksjoner endres aldri: bare reserverte nøkkelord følger valget. For lange filer gjør ensartet formatering det også mye enklere å gå gjennom forskjeller mellom versjoner.