Come formattare SQL con rientri e parole chiave leggibili

A cosa serve formattare una query SQL

SQL Formatter serve a rendere più leggibile il testo SQL senza eseguirlo né collegarsi a un database. Inserisci una o più istruzioni, scegli il numero di spazi per il rientro e ottieni una versione con i termini SQL in maiuscolo e una struttura più ordinata. È utile per controllare rapidamente una query prima di inserirla in documentazione, in una revisione del codice o in un ambiente di sviluppo.

Il campo per il dialetto può essere compilato, ma non modifica le regole di analisi o formattazione applicate dal percorso disponibile. Perciò il risultato va letto come una riformattazione del testo fornito, non come una verifica della compatibilità della query con un particolare database.

Come formattare SQL passo dopo passo

1. Incolla nel campo SQL una o più istruzioni. Il valore deve essere testo; se non inserisci nulla, il campo usa un valore vuoto predefinito. Un input composto solo da spazi o ritorni a capo viene accettato e produce un risultato formattato vuoto.

2. Imposta il rientro. Il valore predefinito è 2. Per un input non vuoto, il valore viene convertito in numero intero: se la conversione non riesce oppure il numero è inferiore a 0 o superiore a 8, viene usato 2; gli altri valori convertiti vengono mantenuti. Con un input formato soltanto da spazi, questa conversione non viene applicata.

3. Lascia il dialetto generico, salvo che tu voglia comunque fornire un valore descrittivo. Il campo viene accettato, ma non attiva una formattazione specifica per PostgreSQL, MySQL, SQL Server o altri sistemi.

4. Avvia la formattazione e controlla il risultato. Quando l’analisi riesce, il testo viene riorganizzato con nuovi rientri e parole chiave SQL in maiuscolo. Se hai inserito più istruzioni riconosciute, vengono unite con un punto e virgola seguito da un ritorno a capo, con un punto e virgola finale.

5. Se non ottieni un risultato, controlla il tipo e la dimensione dell’input. Il testo SQL deve essere una stringa e, quando non è vuoto, non può superare 1.000.000 di byte UTF-8. La formattazione può inoltre fallire se non vengono riconosciute istruzioni SQL oppure se si verifica un errore durante l’analisi o la formattazione.

Come leggere il risultato

Un risultato riuscito indica che il testo fornito è stato riorganizzato dal percorso di analisi disponibile. Il rientro e le maiuscole rendono più semplice seguire clausole, sottoquery e condizioni, ma il risultato non dimostra che la query sia valida per il tuo database e non mostra l’esito della sua esecuzione.

Se compaiono più istruzioni, verifica che la separazione con punto e virgola sia adatta al contesto in cui copierai il testo. Considera inoltre che la riformattazione non deve essere interpretata come garanzia di conservazione identica del testo originale, dei commenti o della semantica in ogni situazione. In caso di errore, riduci il contenuto a una singola istruzione e controlla la sintassi di base; se il problema persiste, il percorso di analisi potrebbe non riuscire a elaborare quel testo.

Esempio pratico

Devi rendere leggibile una SELECT ricevuta in una sola riga prima di inserirla nella documentazione tecnica.

Incolla una SELECT con una clausola WHERE e imposta il rientro a 4; poi avvia la formattazione e osserva la disposizione delle clausole.

Il risultato presenta le parole chiave SQL in maiuscolo, una struttura rientrata e, per l’istruzione riconosciuta, il punto e virgola finale.

Limiti

• Il campo del dialetto non applica regole specifiche del database. La formattazione non equivale all’esecuzione, alla validazione dei risultati o alla garanzia che il testo mantenga in ogni caso identici commenti, semantica e contenuto originale.

Errori comuni

• Un rientro scritto come testo non numerico o fuori dall’intervallo da 0 a 8 viene riportato a 2 per gli input non vuoti. Inserisci un numero intero compreso nell’intervallo se vuoi controllare il livello di rientro.

Domande frequenti

Posso lasciare vuoto il campo SQL?

Sì, un input composto solo da spazi o ritorni a capo viene accettato e produce un risultato formattato vuoto. Un input non vuoto deve invece essere una stringa e rispettare il limite di 1.000.000 di byte UTF-8.

La scelta del dialetto cambia la formattazione?

Il valore viene accettato, ma il percorso di formattazione disponibile non applica regole specifiche del dialetto. Non usarlo quindi per verificare la compatibilità con un database preciso.

Lo strumento esegue la query SQL?

No. Il percorso analizza e formatta il testo fornito; non esegue la query, non si collega a un database e non verifica i risultati dell’istruzione.