Formattatore SQL
Formatta, minimizza ed esegui l'escape di SQL

Che cosa fa per te un formattatore SQL

Una query copiata da un log o da uno strumento sta spesso su una sola lunga riga. Non puoi leggerla né rivederla. Perciò devi spezzarla in righe, aggiungere rientri e mettere ogni clausola al suo posto.

Questo strumento lo fa in una sola casella. Per prima cosa, incolla il tuo SQL. Poi scegli Formatta, e il risultato appare mentre scrivi. Mette SELECT, FROM e WHERE su righe proprie e allinea join e condizioni.

Minimizza anche l'SQL, cosa utile quando devi incollare una query nel codice o in un file di configurazione. Inoltre fa l'escape e il ripristino del testo, così una virgoletta dentro un valore non può rompere la tua istruzione.

Tutto gira nel tuo browser. Così il tuo SQL non lascia mai il tuo dispositivo. Conta, perché le query contengono spesso nomi di tabelle, identificatori e a volte dati reali.

Formattare l'SQL in righe leggibili

Per prima cosa, lo strumento legge il testo e lo divide in token. Così, un token è una parola, un numero, una stringa, un commento o un simbolo. Poiché legge prima stringhe e commenti, una parola chiave tra virgolette non viene mai cambiata.

Poi dispone i token. Ogni clausola principale inizia su una nuova riga. L'elenco del SELECT riceve una colonna per riga quando ne ha più di una. I join iniziano una nuova riga, e gli AND e OR di una condizione si allineano sotto il WHERE.

Le sottoquery stanno tra parentesi e si spostano di un livello a destra. Così vedi dove comincia e finisce ciascuna.

Per maggiori dettagli, vedi: Wikipedia article on SQL.

Rientri, parole chiave e commenti

Scegli tu il rientro. Inoltre, ci sono due spazi, quattro spazi e tabulazioni. Scegli anche le maiuscole delle parole chiave. Il maiuscolo è lo stile classico. Il minuscolo è diffuso nel codice moderno. Una terza scelta lascia le parole chiave come le hai scritte.

Inoltre i commenti sono al sicuro. Un commento di riga resta alla fine della sua riga, e un commento a blocco resta dove l'hai messo. Se preferisci un risultato pulito, disattiva i commenti.

Così lo strumento non cambia nomi, valori o stringhe. Tra l’altro, sposta soltanto gli spazi e cambia le maiuscole delle parole chiave.

Minimizzare l'SQL

Poi c'è la minimizzazione, che fa il contrario. Toglie i commenti e gli spazi in più e tiene uno spazio solo dove due parole si toccherebbero.

Aiuta quando salvi una query in una stringa. Aiuta anche in un URL o in un log. Il risultato è la stessa query, solo più corta. Le note sotto il risultato mostrano quanti caratteri hai risparmiato.

Escape e ripristino del testo SQL

Infatti, una virgoletta dentro un valore chiude una stringa troppo presto. È un bug, e può essere anche una falla di sicurezza. Perciò devi fare l'escape della virgoletta prima di mettere il testo in un'istruzione.

L'SQL standard raddoppia la virgoletta, che diventa due virgolette semplici. MySQL accetta anche una barra rovesciata davanti alla virgoletta. Lo strumento fa entrambe le cose e può aggiungere le virgolette esterne per te.

Poi il ripristino fa il percorso inverso. Toglie le virgolette esterne e riporta a testo normale ogni virgoletta raddoppiata o sequenza con barra rovesciata.

L'escape non è una difesa completa

Così, l'escape aiuta con testo occasionale, come un valore in uno script. Per un'app, usa invece istruzioni preparate con parametri. Tengono separati dati e codice, quindi nessuna virgoletta può cambiare la query.

Il formattatore lascia stare i parametri, come un nome con i due punti o un punto interrogativo. Così un'istruzione preparata resta valida dopo la formattazione.

Quale SQL capisce

Per prima cosa, lo strumento lavora con il nucleo comune dell'SQL. Copre SELECT, INSERT, UPDATE, DELETE, WITH e CREATE TABLE, oltre a join, unioni, funzioni finestra e CASE.

Inoltre legge stringhe tra virgolette semplici, nomi tra virgolette doppie, apici inversi e parentesi quadre, e i due tipi di commenti. Così va bene per il codice MySQL, PostgreSQL, SQL Server, SQLite e Oracle.

Qualche sintassi specifica di un motore può sembrare semplice, ma resta valida. Lo strumento non riscrive mai un'istruzione, quindi non può romperla.

Anche le stored procedure e gli script lunghi funzionano. Lo strumento tratta ogni punto e virgola come la fine di un'istruzione, così uno script con molte istruzioni resta in ordine.

Sicuro per progetto

Lo strumento non esegue mai il tuo SQL e non si collega mai a un database. Inoltre, legge solo testo e scrive solo testo, e lo fa nella tua scheda.