Formattatore SQL

L'importanza della leggibilità del codice SQL

La scrittura di query SQL è fondamentale per l'interazione con i database, ma il codice generato automaticamente, le query complesse con numerose giunzioni o le istruzioni scritte rapidamente tendono a diventare difficili da leggere e mantenere. Un codice SQL non formattato aumenta il tempo necessario per il debug, rende complessa la collaborazione tra sviluppatori, analisti di dati e amministratori di database (DBA), e incrementa il rischio di errori logici durante le modifiche.

L'applicazione di uno stile di formattazione coerente facilita l'individuazione immediata delle tabelle coinvolte, dei filtri applicati e delle relazioni di giunzione. Questo strumento permette di trasformare query disordinate in codice strutturato e pulito direttamente nel browser, migliorando la comprensione del flusso logico dei dati.

Configurazione dell'input e dialetti SQL supportati

Per avviare il processo, l'utente inserisce la query nell'area di input, che supporta una lunghezza massima di 300.000 caratteri. Il comportamento della formattazione può essere personalizzato selezionando parametri specifici per adattarsi alle convenzioni del proprio team o del database in uso:

• Dialetto: Consente di scegliere la sintassi specifica del motore database utilizzato. I dialetti disponibili includono Standard SQL, PostgreSQL, MySQL, MariaDB, SQL Server (T-SQL), Oracle (PL/SQL), SQLite, BigQuery, Snowflake e Spark SQL.
• Rientro: Definisce lo stile di spaziatura per i blocchi di codice nidificati, selezionabile tra 2 spazi, 4 spazi o tabulazione.
• Parole chiave: Regola il registro delle parole chiave SQL, con la possibilità di impostarle in MAIUSCOLO, minuscolo o di selezionare Mantieni per preservare lo stato originale.

Analisi delle metriche e dei risultati generati

Dopo l'elaborazione, lo strumento restituisce il codice SQL formattato e calcola in tempo reale alcune metriche strutturali utili per l'analisi del codice:

Oltre a queste metriche, l'interfaccia mostra lo stato dell'operazione. Se l'elaborazione ha successo, viene visualizzato il messaggio "Formattato.". Se l'utente decide di ripulire l'area di lavoro cliccando sul pulsante "Cancella", l'input e l'output vengono svuotati, gli eventuali dettagli sull'errore vengono nascosti e viene mostrato il messaggio "Cancellato.".

Gestione degli errori e limiti di elaborazione

Il sistema prevede regole precise per la gestione di input non conformi o eccessivamente grandi, garantendo la stabilità dell'applicazione:

• Query troppo grandi: Se il testo inserito supera il limite massimo di 300.000 caratteri, l'elaborazione si interrompe e viene mostrato il messaggio d'errore "Questa query è troppo grande per essere elaborata. Ne provi una più piccola.".
• Errori di sintassi: Nel caso in cui il codice SQL contenga errori di sintassi che impediscono l'analisi strutturale, l'interfaccia mostra l'avviso "Impossibile formattare questo SQL — verifichi la sintassi.". In questa situazione, l'output precedentemente generato non viene sovrascritto o sostituito dal messaggio di errore, consentendo all'utente di non perdere il lavoro precedente.

Spiegazione della query clausola per clausola

Una delle funzionalità principali dello strumento è la capacità di scomporre la query e fornire una spiegazione in linguaggio naturale della sua struttura logica. Questa analisi differisce dai piani di esecuzione dei database (execution plans): non descrive come il motore ottimizza o esegue fisicamente la query sul disco, ma illustra la struttura sintattica del codice. Per questo motivo, la spiegazione funziona anche su frammenti di codice parziali o contenenti elementi specifici di un singolo fornitore.

Quando viene attivata l'analisi, l'interfaccia mostra la dicitura "Analizzate {count} istruzioni." per indicare il numero di istruzioni rilevate. Se la query contiene più istruzioni, ognuna viene identificata dall'etichetta "Istruzione {n}". Se l'analisi rileva più di 25 istruzioni, lo strumento elabora e mostra solo le prime 25, aggiungendo la nota "Vengono mostrate solo le prime 25.".

Per ogni istruzione viene identificata la tipologia generale (Kind) e il ruolo specifico di ciascuna clausola (Role):

Tipi di istruzione (Kind) rilevati

• SELECT: Una query che legge e restituisce righe senza apportare modifiche.
• INSERT: Aggiunge nuove righe a una tabella.
• UPDATE: Modifica i valori nelle righe già esistenti.
• DELETE: Rimuove righe da una tabella.
• CREATE: Definisce un nuovo oggetto come una tabella, una vista o un indice.
• ALTER: Modifica la definizione di un oggetto esistente.
• DROP: Rimuove definitivamente un oggetto dal database.
• TRUNCATE: Svuota una tabella, eliminando tutte le righe.
• WITH: Crea un set di risultati temporaneo con nome (CTE) per la query successiva.
• MERGE: Inserisce, aggiorna o elimina righe in un'unica operazione combinata.
• OTHER: Un'istruzione SQL.

Ruoli delle clausole (Role) analizzati

• SELECT: Le colonne e le espressioni restituite.
• SELECT DISTINCT: Le colonne restituite, con rimozione delle righe duplicate.
• FROM: La tabella (o sottoquery) da cui vengono letti i dati.
• JOIN: Combina ogni riga con le righe corrispondenti di un'altra tabella.
• WHERE: Mantiene solo le righe che soddisfano questa condizione.
• GROUP BY: Raggruppa le righe in modo da poter calcolare aggregazioni come COUNT o SUM per ciascun gruppo.
• HAVING: Filtra i gruppi dopo il calcolo delle aggregazioni.
• ORDER BY: Ordina le righe risultanti.
• LIMIT: Limita il numero di righe restituite.
• OFFSET: Salta un determinato numero di righe prima di restituire i risultati.
• UNION: Combina questi risultati con quelli di un'altra query.
• VALUES: I valori delle righe che vengono inseriti.
• INTO: La tabella che riceve le nuove rijghe.
• SET: I nuovi valori da assegnare alle colonne.
• UPDATE: La tabella le cui righe vengono modificate.
• DELETE FROM: La tabella da cui vengono rimosse le righe.
• WITH: Definisce un set di risultati temporaneo con nome utilizzato di seguito.
• STATEMENT: L'istruzione, mostrata così com'è.

Elaborazione locale e riservatezza dei dati

Il funzionamento dello strumento si basa interamente sull'esecuzione lato client. L'SQL inserito viene formattato e analizzato direttamente all'interno del browser dell'utente. Nessun dato o frammento di codice viene caricato sui server di BroBroGo, garantendo che le query non lascino mai la pagina web locale. Inoltre, lo strumento memorizza le bozze di lavoro e le preferenze relative al tema visivo esclusivamente all'interno della memoria locale del browser dell'utente.

Domande frequenti (FAQ)

Quali dialetti SQL è possibile formattare?

SQL standard, PostgreSQL, MySQL, MariaDB, SQL Server (T-SQL), Oracle (PL/SQL), SQLite, BigQuery, Snowflake e Spark SQL. Selezioni quello corrispondente al suo database in modo che le parole chiave e le virgolette vengano gestite come previsto dal motore specifico.

Come funziona la spiegazione in linguaggio naturale?

Legge la struttura della query — il tipo di istruzione e ogni clausola come SELECT, FROM, JOIN, WHERE, GROUP BY e ORDER BY — e ne descrive la funzione. Spiega la struttura logica della query, non il piano di esecuzione del database, pertanto funziona anche su SQL parziale o specifico di un determinato fornitore.

È sicuro incollare query di produzione?

Sì. La formattazione e l'analisi vengono eseguite interamente nel browser — il suo SQL non lascia mai la pagina.

Cosa succede se la mia query contiene errori di sintassi?

Se lo strumento rileva un errore di sintassi, mostra il messaggio "Impossibile formattare questo SQL — verifichi la sintassi.". L'output generato in precedenza non viene cancellato, permettendo di correggere il codice senza perdere le modifiche precedenti.