---
title: "DuckDB UI vs DuckLocal: quale interfaccia locale per DuckDB usare"
description: "DuckDB UI è un notebook nel browser; DuckLocal è uno spazio di lavoro desktop. Come differiscono, quando scegliere DuckDB UI e come eseguirla dentro DuckLocal con CALL start_ui()."
language: "it"
---

# DuckDB UI vs DuckLocal: quale dovresti usare?

Entrambi offrono un'interfaccia locale a DuckDB. Uno è un notebook nel browser che qualsiasi processo DuckDB può aprire; l'altro è uno spazio di lavoro desktop costruito intorno ai tuoi file. Rispondono a esigenze diverse, e puoi eseguire l'uno dentro l'altro.

![DuckDB UI vs DuckLocal, con l'anatra di DuckLocal a un portatile](https://ducklocal.app/assets/blog/duckdb-ui-vs-ducklocal-cover.webp)

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](https://duckdb.org/2025/03/12/duckdb-ui) · [Documentazione dell'estensione UI](https://duckdb.org/docs/current/core_extensions/ui.html) · [duckdb/duckdb-ui su GitHub](https://github.com/duckdb/duckdb-ui). 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`](https://ducklocal.app/it/docs/dashboards) 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](https://ducklocal.app/it/use-cases/ai-agent-sql/) 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:

```text
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.

![La scheda Extensions di DuckLocal con l'estensione ui contrassegnata come Loaded, accanto alla schermata iniziale Drop your data in](https://ducklocal.app/assets/blog/ducklocal-extensions-ui.webp)

*L'estensione `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 da `ui.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, e `CALL 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](https://ducklocal.app/it/docs/schema-and-history#duckdb-ui) · [Scheda Extensions](https://ducklocal.app/it/docs/schema-and-history#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.

## Link correlati

- [La DuckDB Local UI (blog di DuckDB)](https://duckdb.org/2025/03/12/duckdb-ui)

- [Documentazione dell'estensione UI](https://duckdb.org/docs/current/core_extensions/ui.html)

- [Analisi dei dati locali con DuckLocal](https://ducklocal.app/it/use-cases/local-data-analysis/)

- [Cosa mi hanno insegnato le Claude Dashboards su DuckLocal](https://ducklocal.app/it/blog/claude-dashboards-ducklocal/)

[← Tutti gli articoli](https://ducklocal.app/it/blog/)

Fonte: https://ducklocal.app/it/blog/duckdb-ui-vs-ducklocal/
