A marzo 2025, DuckDB 1.2.1 è arrivato con DuckDB UI: esegui duckdb -ui e un notebook si apre nel browser, supportato dal processo DuckDB sulla tua macchina. Da allora, la domanda più comune che ricevo su DuckLocal è una qualche versione di “perché non usare semplicemente DuckDB UI?”
È una domanda legittima. Entrambi gli strumenti eseguono DuckDB localmente, nessuno dei due richiede un server da gestire e entrambi mantengono query e dati sul tuo computer. Ma partono da punti diversi, e quella differenza decide quale si adatta a un dato lavoro. Questo articolo è il mio tentativo sincero di spiegarlo — compresi i casi in cui ricorrerei io stesso a DuckDB UI.
1. La risposta breve
| Se… | Usa |
|---|---|
| lavori già nella CLI di DuckDB o in Python e vuoi una vista visuale di quella sessione | DuckDB UI |
| pensi in notebook di celle SQL | DuckDB UI |
| usi MotherDuck o vuoi condividere i risultati tramite esso | DuckDB UI |
| parti da una massa di file e cartelle CSV, Parquet, JSON o Excel | DuckLocal |
| devi lavorare offline, o vuoi che ogni parte dello strumento sia installata e verificabile | DuckLocal |
| vuoi grafici e dashboard che puoi salvare come file e tenere in git | DuckLocal |
| vuoi che un agente AI interroghi gli stessi dati da un terminale | DuckLocal |
| vuoi entrambi sugli stessi dati | DuckLocal, poi CALL start_ui(); |
2. Cos'è DuckDB UI
DuckDB UI è costruita e mantenuta da MotherDuck e distribuita come estensione DuckDB chiamata ui. La avvii con duckdb -ui dal terminale, oppure con CALL start_ui(); da qualsiasi client DuckDB — la CLI, Python, Java e così via.
L'estensione avvia un server HTTP su localhost (porta 4213 per impostazione predefinita) dentro il processo DuckDB che l'ha chiamata, e apre il browser. Poiché l'interfaccia parla proprio con quel processo, vede tutto ciò che vede il processo: i database collegati, la sua memoria e i tuoi file locali.
Cosa ottieni nel browser:
- Notebook — raccolte nominate e salvate di celle SQL, con evidenziazione della sintassi e completamento automatico. Una cella può contenere più istruzioni.
- Un browser dei database collegati con un riepilogo delle tabelle: numero di righe, colonne, tipi e un profilo per colonna.
- Un Column Explorer che riassume un risultato e ti permette di approfondire ogni colonna.
- Accesso opzionale a MotherDuck, per rendere persistenti le tabelle nel data warehouse cloud di MotherDuck e condividerle. È opt-in; per impostazione predefinita nulla lascia la tua macchina.
Due dettagli contano per il confronto. Primo, il server locale dell'estensione scarica i file frontend dell'interfaccia da https://ui.duckdb.org così l'interfaccia resta aggiornata; le tue query vengono comunque eseguite localmente, ma l'interfaccia stessa viene caricata dalla rete. L'uso offline non era supportato al lancio. Secondo, l'estensione è rilasciata con licenza MIT, mentre al lancio il codice sorgente del frontend non era pubblicato.
Fonti: Annuncio di DuckDB UI · Documentazione dell'estensione UI · duckdb/duckdb-ui su GitHub. Verificale per eventuali modifiche successive alla scrittura di questo articolo.
3. Confronto affiancato
| Dimensione | DuckDB UI | DuckLocal |
|---|---|---|
| Che cos'è | Un notebook nel browser servito dall'estensione ui di DuckDB | Un'app desktop nativa con DuckDB incorporato |
| Come si avvia | duckdb -ui o CALL start_ui(); da qualsiasi client DuckDB (1.2.1 o successivo) | Apri l'app, oppure esegui ducklocal ./data/ |
| Dove vengono eseguite le query | Nel processo DuckDB che l'ha avviata, sulla tua macchina | Nel DuckDB incorporato di DuckLocal, sulla tua macchina |
| File dell'interfaccia | Scaricati dal server locale da ui.duckdb.org | Inclusi nell'app |
| Offline | Richiede la rete per i file dell'interfaccia | Funziona offline; la rete è usata solo per S3, tile delle mappe, installazione di estensioni e controlli degli aggiornamenti che attivi |
| Importare dati | SQL: read_csv, ATTACH o ciò che la sessione ha già | Trascina file, cartelle e pattern glob; diventano viste e sono lì al prossimo avvio |
| Modo di lavorare | Notebook di celle SQL | Schede di query, barra laterale dello schema, cronologia, EXPLAIN e un profiler |
| Esplorare i risultati | Riepiloghi delle tabelle e Column Explorer | Griglia dei risultati, scheda Overview per colonna e grafici integrati |
| Riuso e condivisione | Notebook salvati; condivisione opzionale via MotherDuck | Dashboard .dash in testo semplice che puoi rivedere e tenere in git, con commenti ai grafici |
| Agenti AI | Non è il suo focus | CLI ducklocal con JSON limitato e una skill ufficiale per agenti |
| Sorgente | Estensione con licenza MIT; frontend non pubblicato al lancio | Apache-2.0, app e sorgente su GitHub |
| Piattaforme | Ovunque giri DuckDB, tranne windows_arm64 | macOS su Apple silicon, Windows x64, Linux x86_64 |
Il modo più breve in cui posso dirlo: DuckDB UI è una finestra su una sessione DuckDB che hai già. DuckLocal è la sessione, costruita intorno ai file che vuoi guardare.
4. Quando usare DuckDB UI
Lavori già dentro DuckDB
Se il tuo lavoro avviene nella CLI di DuckDB o in uno script Python, l'interfaccia è a un comando di distanza e non richiede una nuova app. Esegui duckdb -ui my.duckdb, oppure chiama start_ui() dal processo Python che ha già caricato e trasformato i tuoi dati, e stai guardando esattamente quello stato. DuckLocal non può vedere dentro un altro processo; l'interfaccia è progettata per farlo.
Pensi in notebook
Alcune analisi sono una lunga sequenza di passaggi che vuoi mantenere in ordine: caricare, pulire, unire, verificare, riepilogare. I notebook con celle nominate e salvate si adattano bene a questo, e una cella può eseguire più istruzioni contemporaneamente. Le schede di query di DuckLocal sono migliori per porre molte domande separate che per mantenere una lunga narrazione.
Usi MotherDuck
Se il tuo team condivide già dati tramite MotherDuck, l'interfaccia è il front end naturale: accedi e lo stesso notebook raggiunge sia DuckDB locale sia il tuo data warehouse cloud. DuckLocal non ha un servizio cloud e non ne prevede uno.
DuckLocal non ha una build per la tua macchina
DuckLocal è distribuito per macOS su Apple silicon, Windows x64 e Linux x86_64. Su un Mac Intel, per esempio, dovresti compilare DuckLocal dal sorgente, mentre DuckDB UI funziona ovunque funzioni DuckDB (tranne Windows su ARM).
5. Quando usare DuckLocal
Parti dai file, non dall'SQL
Trascina un CSV, una cartella di file Parquet o un pattern come ./logs/2026-*/*.json, e ognuno diventa una vista che puoi interrogare, con le sue colonne nella barra laterale. Ogni foglio non vuoto di una cartella di lavoro Excel diventa una tabella. Non serve scrivere prima read_csv(…), e i file sono ancora lì la prossima volta che apri l'app.
Ti serve che funzioni offline, o che sia completamente verificabile
L'interfaccia di DuckLocal fa parte dell'app che hai installato. Non carica codice dell'interfaccia a runtime, non scarica estensioni da sola e i controlli degli aggiornamenti sono disattivati finché non li attivi. Il frontend di DuckDB UI, al contrario, viene scaricato all'avvio dell'interfaccia e può leggere i dati caricati in DuckDB — la documentazione di DuckDB stessa consiglia di puntarlo solo a un URL di cui ti fidi. Per la maggior parte delle persone va bene. Per revisioni di sicurezza, audit, dati regolamentati o macchine air-gapped, “tutto è installato e open source” è la garanzia più forte.
Vuoi grafici e dashboard come file
I risultati diventano grafici a barre, linee, dispersione, torta e mappa sul posto. Quando una vista vale la pena di essere conservata, un file .dash descrive query, grafici e filtri come testo semplice — qualcosa che puoi mettere in diff, rivedere in una pull request e validare con ducklocal check.
Lavori con un agente AI
La ducklocal CLI offre a un agente un flusso di lavoro SQL schema-first, con una sola istruzione e output JSON limitato, e i commenti alle dashboard ti permettono di affidargli una domanda su un grafico specifico. Gli stessi file sono aperti nell'app perché tu possa verificare il suo lavoro.
6. Eseguire DuckDB UI dentro DuckLocal
Non devi scegliere. DuckDB UI è un'estensione, e DuckLocal può caricare estensioni DuckDB — quindi l'interfaccia gira sopra l'istanza DuckDB di DuckLocal:
- Apri la scheda Extensions nella barra laterale di DuckLocal.
- Fai clic su Install nella riga
ui, poi su Load. DuckLocal non installa mai estensioni da solo, quindi questo passaggio è deliberato. - In una scheda di query, esegui:
CALL start_ui();
Il browser apre DuckDB UI su http://localhost:4213. È collegata all'istanza DuckDB in esecuzione in DuckLocal, quindi i file che hai aperto in DuckLocal sono lì per essere usati in un notebook.
ui caricata nella scheda Extensions di DuckLocal. Da qui, CALL start_ui(); apre DuckDB UI sulla stessa istanza DuckDB.Alcune cose utili da sapere:
- Serve la rete: una volta per installare
ui, e ogni volta che si avvia, per scaricare i file dell'interfaccia daui.duckdb.org. - Termina con DuckLocal. Uscire da DuckLocal chiude la sua istanza DuckDB e con essa il server dell'interfaccia.
CALL stop_ui_server();lo ferma prima, eCALL start_ui_server();lo avvia senza aprire un browser. - I notebook appartengono all'estensione, salvati in
~/.duckdb/extension_data/ui/. La cronologia delle query di DuckLocal non include ciò che esegui nell'interfaccia. - Non può essere eseguita direttamente su un database di sola lettura. Collega quel database da un notebook con
ATTACH '…' (READ_ONLY).
Ecco come le uso insieme: DuckLocal per aprire i dati, guardare le colonne e rappresentare le domande ovvie; DuckDB UI quando una domanda diventa un'indagine più lunga che voglio conservare come notebook.
Documentazione: Aprire DuckDB UI da DuckLocal · Scheda Extensions
7. FAQ
Qual è la differenza tra DuckDB UI e DuckLocal?
DuckDB UI è un notebook basato sul browser servito dall'estensione ui di DuckDB dal processo DuckDB che lo avvia. DuckLocal è un'app desktop nativa con DuckDB incorporato, costruita intorno all'apertura di file e cartelle, grafici, dashboard in testo semplice e una CLI per agenti AI. Entrambi eseguono le query localmente.
DuckLocal sostituisce DuckDB UI?
No. Si sovrappongono nell'esecuzione di SQL su dati locali, ma l'interfaccia è migliore come finestra su una sessione DuckDB esistente e DuckLocal come spazio di lavoro per i file. Poiché l'interfaccia gira dentro DuckLocal, puoi usare entrambe.
DuckDB UI funziona offline?
Le tue query vengono eseguite localmente, ma i file frontend dell'interfaccia vengono scaricati da ui.duckdb.org a ogni avvio, quindi serve accesso alla rete. L'interfaccia di DuckLocal è inclusa nell'app e funziona offline.
Le mie query vanno a MotherDuck?
Non a meno che tu non acceda a MotherDuck nell'interfaccia. Per impostazione predefinita, DuckDB UI esegue le tue query sulla tua macchina, come fa DuckLocal.