Come scrivere SQL con l'AI: una guida pratica per sviluppatori (2026)

Qualsiasi LLM generico ti scriverà volentieri uno statement SELECT. Quello in cui sono scarsi è sapere che la tua tabella users in realtà si chiama accounts, che status è un enum salvato come intero e che deleted_at IS NOT NULL significa che la riga è stata eliminata in modo soft, non che non esiste. Finisci per incollare statement CREATE TABLE in una chat, cosa che stanca in fretta e diventa obsoleta appena cambia lo schema.

La soluzione è dare al modello accesso diretto al tuo schema, così può cercare queste informazioni da solo invece di fartele spiegare ogni volta. Questa guida ti accompagna nell'intero flusso di lavoro: connessione, domanda in linguaggio naturale, revisione del risultato e uso dell'AI per spiegare o ripulire una query che hai già scritto. Useremo l'AI Shell di Beekeeper Studio per mostrarlo in concreto, visto che è lo strumento che conosciamo meglio, ma il flusso di base (prompt che conoscono lo schema, revisione prima dell'esecuzione) vale qualunque strumento tu usi.

Se prima vuoi un confronto più ampio degli strumenti AI per SQL sul mercato, dai un'occhiata alla nostra rassegna di app e servizi AI per SQL.

Cosa ti serve

• Un database a cui connetterti (Postgres, MySQL, SQLite, SQL Server, quello che vuoi)
• Beekeeper Studio. L'AI che conosce lo schema non è inclusa nella Community edition gratuita, ma puoi provarla gratis per 14 giorni, senza registrazione né carta di credito
• Una API key di un provider LLM che usi già (funzionano sia Claude che OpenAI), oppure un modello Ollama locale se preferisci tenere tutto sulla tua macchina

Nessun ricarico sui costi delle API e nessun account Beekeeper richiesto. Paghi direttamente il tuo provider del modello, come se chiamassi la sua API da uno script.

Passo 1: connettiti al database e apri un'AI Shell invece di una scheda query

Connettiti come fai di solito. L'unica differenza rispetto al tuo flusso abituale è che, dove apriresti una nuova scheda query, vedrai un menu a tendina che ti permette di aprire invece una scheda AI Shell.

La prima volta sceglierai un provider e inserirai la tua API key. Da lì in poi viene ricordata per quella connessione, così non devi reinserirla a ogni sessione.

Passo 2: fai la tua domanda in linguaggio naturale

Scrivi quello che vuoi davvero sapere, non una descrizione delle tue tabelle. L'AI Shell ha già accesso al tuo schema, quindi non serve spiegarlo in anticipo.

Guarda cosa succede dopo: controlla le colonne delle tabelle che ritiene rilevanti prima di scrivere anche una sola riga di SQL. È questa la parte che conta davvero. Non tira a indovinare i nomi delle colonne partendo dal nome della tabella: li verifica.

Passo 3: controlla prima di approvare

Di default, l'AI Shell chiede prima di fare qualsiasi cosa: prima di leggere lo schema di una tabella e prima di eseguire una query. Ogni passaggio ha la sua conferma Yes / No, quindi non succede nulla senza un tuo clic.

È il passaggio che si salta una volta che ci si fida dello strumento, ed è proprio quello che non dovresti saltare. Leggi l'SQL generato prima di confermare, soprattutto le condizioni di JOIN e qualsiasi clausola WHERE che filtra le righe. Un modello che sbaglia di poco sulla relazione tra due tabelle restituirà comunque un risultato, solo che sarà quello sbagliato, e un numero sbagliato ma plausibile è più pericoloso di un errore evidente.

Se preferisci non confermare ogni singola lettura, c'è un'impostazione apposita: Settings → General → Always allow execution of read-only queries. Esegue in automatico gli statement SELECT ma chiede comunque conferma prima di qualsiasi scrittura. Vale la pena attivarla quando ti sei fatto un po' di fiducia nello strumento con il tuo database; non è qualcosa che consiglierei dal primo giorno.

Passo 4: leggi la risposta, non solo la query

Una volta approvata la query, ottieni il result set più un riepilogo in linguaggio naturale sotto. È qui che l'AI vale più del semplice scriverti l'SQL: è utile anche per verificare a colpo d'occhio se i numeri hanno senso prima di copiarli in un report o passarli a qualcun altro.

Passo 5: affina con domande successive

Se il primo risultato non è proprio giusto, non ricominciare da capo. Continua la conversazione:

“Puoi escludere gli ordini annullati?”

“Raggruppa per mese invece”

“Sembra strano, stiamo contando qualcosa due volte per colpa della join?”

Dato che l'AI Shell mantiene nel contesto lo schema e la cronologia delle query, le domande successive costano poco. Non devi rispiegare le tabelle ogni volta: stai affinando una query che ha già davanti. Puoi anche modificare a mano l'SQL generato se fai prima: niente ti impedisce di trattarlo come un punto di partenza invece che come una risposta definitiva.

Passo 6: usala sulle query che hai già scritto

La stessa scheda AI Shell funziona anche con il tuo SQL, non solo con le query che genera. Incolla qualcosa di contorto che hai ereditato, una join su cinque tabelle senza commenti, e chiedile di spiegarti cosa fa la query o dove aggiungere un indice per velocizzarla. Onestamente è uno degli usi più sottovalutati dell'AI in un client per database: capire vecchio SQL spesso fa perdere più tempo che scriverne di nuovo.

L'unica regola che conta più di tutte

Non eseguire mai SQL generato dall'AI su un database a cui tieni senza prima leggerlo, soprattutto se contiene UPDATE, DELETE o DROP. L'AI Shell chiede il permesso di default proprio perché “sembra giusto” ed “è giusto” non sono la stessa cosa, e lo strumento non ha idea se “elimina gli account di test” significhi i tre a cui stai pensando tu o ogni riga dove email LIKE '%test%'. Trattala come un junior engineer molto veloce e molto preparato: ottime prime bozze, ma vale sempre la pena di un secondo paio d'occhi prima di rilasciare, e ancora di più prima di eseguirle in produzione.

Provala tu stesso

Puoi provare l'AI Shell gratis per 14 giorni, senza registrazione né carta di credito, e senza costi d'uso extra oltre a quelli del tuo provider del modello.

Scarica Beekeeper Studio gratis

Vuoi prima più dettagli su installazione e configurazione? La pagina della funzionalità SQL AI Shell e la documentazione completa coprono il resto. E se stai ancora confrontando strumenti, la nostra rassegna di app e servizi AI per SQL è un buon passo successivo.