Formattatore e Abbellitore SQL

No. Il formatter modifica solo gli spazi bianchi, l'indentazione e (opzionalmente) il maiuscolo delle lettere delle keyword. La struttura logica — nomi delle tabelle, nomi delle colonne, condizioni, join, espressioni — non viene mai alterata. Una query formattata produce esattamente lo stesso risultato dell'originale quando eseguita su un database. Puoi formattare in sicurezza e poi copiare nuovamente nella tua applicazione senza alcun rischio di introdurre modifiche alla logica.

Sì. I commenti SQL su una sola riga (-- commento fino a fine riga) e i commenti a blocco (/* commento multi-riga */) vengono riconosciuti e preservati nell'output formattato. Le stringhe letterali (valori tra virgolette singole), gli identificatori quotati (backtick o doppia virgoletta a seconda del dialetto) e le stringhe numeriche vengono tutti gestiti correttamente — non vengono mai suddivisi su più righe né modificati durante la formattazione. Vengono preservate anche le virgolette annidate e i caratteri sfuggiti all'interno delle stringhe.

Non esiste un requisito standard SQL — le keyword funzionano in qualsiasi formato nella maggior parte dei database. Tuttavia, l'uso di keyword in maiuscolo (SELECT, FROM, WHERE, JOIN) è la convenzione predominante nel codice SQL per una ragione chiave: la leggibilità. Quando esamini una query SQL formattata, le keyword in maiuscolo risaltano rispetto ai nomi delle tabelle/colonne in minuscolo, rendendo immediatamente visibile la struttura della query. Questo strumento utilizza per impostazione predefinita le keyword in maiuscolo, che è la convenzione nella maggior parte delle guide di stile SQL, incluse quelle di Google, GitLab e Kickstarter.

Sì, per scopi di formattazione generale. La sintassi SQL di base (SELECT, JOIN, WHERE, ecc.) è standard su MySQL, PostgreSQL, SQLite, SQL Server e Oracle. La sintassi specifica del database viene solitamente accettata ma potrebbe non essere formattata perfettamente — ad esempio, il casting di tipo specifico di PostgreSQL (::), le funzioni specifiche T-SQL di SQL Server o la sintassi LIMIT/OFFSET di MySQL. Se vedi una formattazione inaspettata nel codice specifico di un dialetto, la logica rimane corretta — potrebbe variare solo la presentazione dell'indentazione.

L'SQL non formattato è una fonte comune di bug non rilevati nelle code review. Quando una query è su un'unica lunga riga, è facile ignorare una condizione JOIN mancante (che causa un prodotto cartesiano), una clausola WHERE omessa accidentalmente (che influisce su tutte le righe) o la precedenza errata nelle condizioni AND/OR. L'SQL formattato mette ogni clausola e condizione su una propria riga, rendendo gli errori strutturali visivamente evidenti. Molti team richiedono che l'SQL sia formattato prima della revisione proprio per questo motivo.

Viene gestito l'SQL multi-istruzione di base (multiple istruzioni SELECT o INSERT separate da punti e virgola) — ogni istruzione viene formattata indipendentemente. Tuttavia, le stored procedure, PL/pgSQL, i blocchi T-SQL con BEGIN/END e l'SQL procedurale complesso potrebbero non essere formattati correttamente poiché il formatter si concentra sulle istruzioni standard DML/DDL. Per le stored procedure, prova a formattare le singole istruzioni all'interno del corpo della procedura invece dell'intera definizione della procedura.

No. Tutta la formattazione avviene nel tuo browser utilizzando JavaScript. Le tue query SQL, inclusi nomi di tabelle, nomi di colonne, valori di dati o stringhe di connessione nella query, non lasciano mai il tuo dispositivo. Questo rende sicuro formattare query di produzione contenenti riferimenti a dati reali o informazioni su schemi proprietari.