SQL formater

Kako formatirati SQL upit

1. Zalijepi jedan ili više upita ili klikni na Otvori datoteku da učitaš datoteku .sql (do 10 MB).
2. Odaberi Dijalekt svoje baze podataka, na primjer PostgreSQL, MySQL ili SQL Server (T-SQL).
3. Odaberi kako se pišu Ključne riječi (VELIKA SLOVA, mala slova ili Ostavi kako je upisano) i Uvlačenje.
4. Označi Bez razmaka oko operatora ako preferiraš a=b+1 umjesto a = b + 1.
5. Klikni na Formatiraj SQL, pa kopiraj ili preuzmi rezultat. Promjena opcije ponovo formatira upit.

Upit se samo preoblikuje kao tekst. Nikada se ne izvršava i nikada se ne šalje bazi podataka ni serveru.

Šta formater radi

Alat koristi biblioteku otvorenog koda sql-formatter. Svaku naredbu dijeli na klauzule i svaku ključnu riječ klauzule (SELECT, FROM, WHERE, GROUP BY, ORDER BY…) stavlja u poseban red, a sadržaj klauzule uvlači ispod nje. Kolone u listi SELECT postavljaju se jedna po redu, uvjeti AND i OR počinju u novim redovima, a podupiti i izrazi CASE uvlače se prema nivou ugniježđenja. Kratki izrazi u zagradama ostaju u jednom redu. Više naredbi razdvojenih tačkom-zarezom drži se razdvojeno praznim redom.

Mijenjaju se samo razmaci i veličina slova. Tekstualni literali, citirani identifikatori i komentari ostaju tačno onakvi kakvi jesu, pa formatirani upit vraća isti rezultat kao izvorni.

Zašto je dijalekt važan

SQL baze dijele osnovni jezik, ali se razlikuju u detaljima, a formater ih mora poznavati da bi upit pravilno pročitao:

• identifikatori se navode pod "dvostrukim navodnicima" u standardnom SQL-u i PostgreSQL-u, `obrnutim apostrofima` u MySQL-u, MariaDB-u i BigQueryju te [uglastim zagradama] u SQL Serveru;
• operatori poput PostgreSQL-ovog ->> i pretvaranja tipova :: ili Snowflakeovog pristupa putanji pomoću : postoje samo u nekim dijalektima;
• oznake parametara se razlikuju: ?, $1, :name ili @name;
• svaki dijalekt ima vlastite rezervisane riječi i funkcije, na koje utiče opcija Ključne riječi.

Ako dobiješ poruku „Upit se nije mogao obraditi“, prvo provjeri da odabrani dijalekt odgovara tvojoj bazi. Greška prikazuje red i kolonu u kojoj je obrada stala. Standardni SQL je najrestriktivniji izbor; kad god je moguće, odaberi svoju stvarnu bazu.

Velika i mala slova i savjeti o stilu

Ključne riječi velikim slovima ostaju najčešća konvencija jer jezik na prvi pogled odvajaju od naziva tabela i kolona. Mala slova su popularna u timovima kojima je tako lakše čitati, a Ostavi kako je upisano ne dira tvoj izbor. Nazivi tabela, kolona i funkcija se nikada ne mijenjaju: opciju slijede samo rezervisane ključne riječi. Kod dugih datoteka dosljedno formatiranje također znatno olakšava pregled razlika između verzija.