Installare SQLite su Windows, macOS e Linux

SQLite è già sul tuo computer (probabilmente)

Prima di installare qualcosa, controlla cosa hai già. SQLite è incluso in macOS, nella maggior parte delle distribuzioni Linux e in tantissime app che usi già. Apri un terminale ed esegui:

sqlite3 --version

Se vedi qualcosa come 3.43.2 2023-10-10 ..., hai finito: salta alla sezione di verifica in fondo a questa pagina. Se ottieni command not found o una versione precedente alla 3.35, continua a leggere. Vedremo Windows, macOS e Linux uno alla volta.

Quello che installi è lo strumento da riga di comando sqlite3. La libreria a cui si collegano i programmi è un pacchetto separato, ma la maggior parte degli installer li fornisce insieme.

Windows: scarica e aggiungi al PATH

Windows non include SQLite, e non esiste un programma di installazione tradizionale: SQLite viene distribuito come un piccolo zip di eseguibili da mettere dove vuoi.

1. Vai su sqlite.org/download.html.
2. Nella sezione Precompiled Binaries for Windows, scarica il file chiamato sqlite-tools-win-x64-*.zip.
3. Estrailo in una cartella. C:\sqlite è una scelta comune.
4. Aggiungi quella cartella al tuo PATH, così puoi eseguire sqlite3 da qualsiasi cartella.

Per aggiungerla al PATH: apri il menu Start, cerca "variabili di ambiente", fai clic su Modifica le variabili di ambiente relative al sistema, poi su Variabili d'ambiente..., trova Path tra le variabili dell'utente, fai clic su Modifica e aggiungi C:\sqlite come nuova voce.

Apri una nuova finestra del terminale (le modifiche al PATH non valgono per i terminali già aperti) e verifica:

sqlite3 --version

Dovresti vedere la stringa della versione. Se ottieni 'sqlite3' is not recognized (o il messaggio equivalente in italiano), la cartella non è nel PATH oppure il nuovo terminale non ha ancora recepito la modifica.

macOS: usa Homebrew per l'ultima versione

macOS include sqlite3 di serie, ma la versione di sistema è indietro di un anno o due rispetto a quella ufficiale. Per i tutorial e l'uso occasionale va bene. Se vuoi le funzionalità recenti (tabelle STRICT, miglioramenti al JSON, window function più complete), installa una versione aggiornata con Homebrew:

brew install sqlite

Homebrew installa SQLite nel proprio prefisso e di proposito non sostituisce la copia di sistema. Per usare la versione di Homebrew come predefinita, mettila in testa al PATH. Aggiungi questa riga al tuo ~/.zshrc:

export PATH="/opt/homebrew/opt/sqlite/bin:$PATH"

(Sui Mac Intel usa invece /usr/local/opt/sqlite/bin.) Ricarica la shell con source ~/.zshrc e controlla:

sqlite3 --version

Se la versione sembra ancora vecchia, sta vincendo il sqlite3 di sistema: verifica che la riga export venga prima di qualsiasi altra modifica al PATH.

Linux: usa il gestore di pacchetti

Quasi tutte le distribuzioni Linux hanno SQLite nei repository predefiniti. Il comando cambia a seconda della distribuzione:

# Debian, Ubuntu, Mint
sudo apt update
sudo apt install sqlite3

# Fedora, RHEL, CentOS Stream
sudo dnf install sqlite

# Arch, Manjaro
sudo pacman -S sqlite

# Alpine
sudo apk add sqlite

Il nome del pacchetto è sqlite3 sui sistemi della famiglia Debian e semplicemente sqlite sulla maggior parte degli altri. Tutti installano lo strumento da riga di comando sqlite3 più la libreria condivisa che gli altri programmi usano per incorporare SQLite.

Se ti serve proprio l'ultima versione e la tua distribuzione è indietro, puoi compilarla dai sorgenti: scarica il tarball dell'amalgamation da sqlite.org ed esegui ./configure && make && sudo make install. Per il 99% degli utenti la versione del gestore di pacchetti va benissimo.

Verificare l'installazione

Qualunque strada tu abbia preso, lo stesso controllo in due passi ti dice che tutto funziona. Prima la versione:

sqlite3 --version

Dovresti vedere un numero di versione, una data e un hash di build. Poi apri la shell di SQLite senza argomenti: ti dà un database in memoria con cui fare prove:

sqlite3

Arriverai a un prompt simile a sqlite>. Scrivi una piccola query per assicurarti che il motore funzioni davvero:

SELECT sqlite_version(), 'Ciao da SQLite' AS greeting;

Dovresti ottenere la stringa della versione e il saluto. Per uscire dalla shell, scrivi .quit e premi Invio. Il punto iniziale è importante: è così che SQLite distingue i comandi della shell (.quit, .help, .tables) dalle istruzioni SQL.

Problemi comuni

Alcune cose che mettono in difficoltà alla prima installazione:

• sqlite3: command not found dopo l'installazione. L'eseguibile c'è, ma non è nel PATH. Su Windows, ricontrolla la variabile di ambiente. Su macOS con Homebrew, verifica che la riga export PATH=... sia nella configurazione della shell e di aver aperto un nuovo terminale.
• Su macOS compare la versione sbagliata. Il sqlite3 di sistema si trova in /usr/bin/sqlite3 e quasi sempre vince per impostazione predefinita. Esegui which sqlite3 per vedere quale sceglie la tua shell. La copia di Homebrew deve venire prima nel PATH.
• .quit non funziona. Probabilmente hai scritto quit senza il punto iniziale, e SQLite prova a interpretarlo come SQL. Inizia sempre i comandi della shell con ..
• Errori di permesso di scrittura quando crei un file di database. SQLite ha bisogno dei permessi di scrittura nella cartella in cui lo esegui. Fai prima cd in una cartella scrivibile, oppure passa un percorso esplicito: sqlite3 ~/mydb.db.

Se sqlite3 --version funziona e riesci a eseguire una SELECT, sei a posto. Tutto il resto di questa documentazione si basa sulla CLI che hai appena installato.

Prossimo passo: la CLI di SQLite

Ora che sqlite3 è nel PATH, il passo successivo è imparare a usarlo. La shell ha un piccolo insieme di dot-command (.tables, .schema, .mode, .import) che la trasformano in un client di database sorprendentemente capace: è il tema della prossima pagina.