Formattare SQL quando la query è una riga sola
Nel ticket un collega incolla una query di 500 caratteri tutta su una riga, e nessuno trova più il WHERE. Il formattatore la divide in blocchi rientrati. Conosce 20 dialetti, tra cui SQL standard, PostgreSQL, MySQL, BigQuery e T-SQL.
Dalla riga unica alla query leggibile
- Incolla la query in SQL in ingresso. L'esempio contiene una
SELECTcon join e sottoquery, unaINSERTe unaUPDATE. - Scegli il Dialetto. Quello predefinito è SQL standard.
- Imposta maiuscole, rientro e le altre opzioni. Ogni modifica riformatta subito.
- Mentre scrivi, la formattazione parte dopo circa 300 ms di pausa. Con Formatta parte subito.
- Premi Copia oppure Scarica .sql per salvare il file
formatted.sql.
Errori di analisi e dialetto sbagliato
Lo SQL standard non conosce il cast di PostgreSQL a::int e non legge nomi come [dbo].[orders] di T-SQL. Compare allora un errore con riga e colonna. Con il dialetto giusto lo stesso testo passa senza problemi.
Segnaposto ?, $1, :name, @name
Le istruzioni preparate contengono segnaposto. Se l'errore punta a uno di essi, apri Stile dei segnaposto e scegli quello del tuo driver. Tutti li accetta tutti e quattro. I segnaposto restano nel testo e non vengono sostituiti da valori.
Parole chiave, operatori, AND e OR
Le parole chiave escono in maiuscolo, in minuscolo o come le hai scritte. Il rientro è di 2 spazi, 4 spazi o una tabulazione. La larghezza delle espressioni (50, 80 o 120 caratteri) decide quanto può essere lunga su una riga un'espressione tra parentesi. Tra le query ci sono 1 o 2 righe vuote. Puoi togliere gli spazi attorno agli operatori (a=b) e mettere AND e OR a inizio o a fine riga.
Cosa lo strumento non fa
Cambia spazi e maiuscole delle parole chiave, nient'altro. Non esegue l'SQL, non conosce le tue tabelle e non dice se la query è corretta. I commenti restano, il testo tra apici non viene toccato. Per lasciare intatto un blocco, racchiudilo tra /* sql-formatter-disable */ e /* sql-formatter-enable */. La libreria non supporta le stored procedure né un delimitatore diverso da ;. Un input oltre 2.000.000 di caratteri viene rifiutato con un messaggio.
Dove finisce il tuo SQL
Da nessuna parte. La libreria fa parte del codice della pagina e gira nel browser. Formattando non parte nessuna richiesta, e lo puoi verificare nel pannello di rete. Copia usa gli appunti, il download crea un file sul tuo dispositivo.