---
title: "Dashboard SQL locali come file di testo | DuckLocal"
description: "Crea dashboard DuckDB come file di testo .dash: query SQL, grafici, schede, mappe e filtri incrociati che girano sul tuo computer, si revisionano in git e che un agente IA può modificare e convalidare."
image: https://ducklocal.app/og-image.jpg?v=2
language: it
---

# Dashboard SQL che puoi leggere, confrontare e revisionare

Una dashboard di DuckLocal è un file di testo `.dash`: fonti di dati, query SQL di DuckDB e i grafici che le disegnano. Gira sul tuo computer sui tuoi file locali, sta in git come il codice e puoi scriverla tu o un agente IA.

Nessun server di BI, nessun account, nessun caricamento di dati. Gratuito e open source per macOS, Windows e Linux.

- File di testo .dash
- Grafici, schede, mappe, tabelle
- Filtri incrociati con un clic
- Convalidate con ducklocal check

## Una dashboard è un file breve

I blocchi `source` indicano i file di dati, i blocchi `query` contengono l’SQL e i blocchi `plot` dicono come disegnare ogni risultato. Un blocco `filter` fa sì che un clic su un grafico filtri gli altri. Niente funzioni o modelli da imparare: solo SQL e qualche attributo.

I percorsi sono relativi al file `.dash`, quindi una cartella con la specifica e i suoi dati funziona ovunque la copi.

[Tutti i blocchi e gli attributi](https://ducklocal.app/docs/it/dashboards#blocks)

```hcl
source "orders" {
  path = "orders.csv"
}

query "revenue" {
  sql = <<SQL
    SELECT channel, sum(amount) AS total
    FROM orders
    GROUP BY channel
    ORDER BY total DESC
  SQL
}

plot "revenue" {
  type  = "bar"
  query = query.revenue
  x     = channel
  y     = total
}
```

## I grafici che servono a una dashboard

Grafici classici, numeri e mappe, disposti su una griglia di 12 colonne.

- **line · area**Serie temporali, fino a 12 serie per grafico
- **bar · stacked_bar**Classifiche e parti di un totale, con i totali
- **scatter · histogram**Relazioni e distribuzioni
- **heatmap**Giorno della settimana per ora, regione per mese
- **map**Punti per latitudine e longitudine, con dimensione e colore
- **timeline**Eventi alla loro reale distanza nel tempo, su corsie
- **card**Un numero, con la sua variazione, buona o cattiva
- **table · text**Righe ordinabili, titoli e note
[Tipi di grafico e opzioni →](https://ducklocal.app/docs/it/dashboards#plot-types)

## Revisiona una dashboard come un documento

Passa il mouse su un grafico, fai clic sul fumetto e scrivi cosa dovrebbe cambiare, ad esempio *«ordinali, il canale più grande per primo»*. Le discussioni accettano risposte e si possono risolvere, e un grafico con discussioni aperte ne mostra il numero.

Un agente IA legge le stesse discussioni con `ducklocal comments`. Ogni discussione indica il suo grafico e le righe del suo blocco nel file. L’agente modifica la specifica, la convalida e risponde. La finestra aperta si ridisegna in meno di un secondo e mostra la risposta, contrassegnata come **Agent**.

[Revisionare con i commenti](https://ducklocal.app/docs/it/dashboards#review-with-comments) · [Cosa mi hanno insegnato le Claude Dashboards su DuckLocal](https://ducklocal.app/it/blog/claude-dashboards-ducklocal/)

```bash
ducklocal comments sales.dash
{"open":1, "threads":[{"id":"c1",
  "plot":"revenue_by_channel",
  "plot_lines":[68,75], ...}]}

ducklocal check sales.dash
ducklocal comments sales.dash --reply c1 \
  --text "Sorted by revenue, descending" --resolve
```

## Verificata prima che qualcuno la apra

`ducklocal check` analizza il file, risolve ogni riferimento ed esegue ogni query in sola lettura. Poi conferma che le colonne di ogni grafico esistono nel risultato reale, così un errore di battitura, una conversione che fallisce o un glob che non trova nulla emergono nel terminale e non in riunione.

Tutti i problemi vengono elencati insieme, uno per `file:line: message`, con codici di uscita utilizzabili da uno script o da un job di CI.

[Convalidare una dashboard](https://ducklocal.app/docs/it/dashboards#validate-a-dashboard)

- Sintassi, nomi e riferimenti controllati
- L’SQL di ogni query eseguito da DuckDB
- Colonne dei grafici confrontate con risultati reali
- Filtri controllati con un valore selezionato
- Query senza righe segnalate

## I dati restano in locale, il file viaggia

Le query girano nel motore DuckDB integrato in DuckLocal, su file del tuo disco o su un database DuckDB. Manda la cartella a qualcuno e vedrà la stessa dashboard sulla sua copia dei dati, senza nulla da pubblicare né spazi di lavoro da condividere.

> **Parti da una singola query?** Qualsiasi risultato dell’editor SQL si può trasformare subito in grafico. Scrivi un file `.dash` quando un insieme di grafici merita di essere conservato. [Risultati e grafici →](https://ducklocal.app/docs/it/results-and-charts)

## Domande sulle dashboard SQL

**Che cos’è un file .dash?** Un file di testo che dichiara una dashboard come blocchi: `source` indica i file di dati, `query` contiene un’istruzione SQL di DuckDB, `plot` disegna un risultato e `filter` fa sì che un clic su un grafico filtri gli altri. Non c’è codice da scrivere.

**Una dashboard richiede un server o un account di BI?** No. DuckLocal apre il file ed esegue le sue query con il motore DuckDB integrato nell’app, sul tuo computer. I file di dati restano dove sono.

**Quali grafici sono disponibili?** Linee, barre, barre impilate, aree, dispersione, torta, mappe di calore, istogrammi, mappe e timeline, oltre a tabelle, schede numeriche con indicatore di variazione e pannelli di testo, su una griglia di 12 colonne.

**Un agente IA può creare o modificare una dashboard?** Sì. Un agente scrive o modifica il file .dash, esegue `ducklocal check` per confermare che ogni query funzioni e che le colonne di ogni grafico esistano, e risponde ai commenti di revisione con `ducklocal comments`. La finestra aperta si ridisegna in meno di un secondo.

**Posso tenere le dashboard in git?** Sì. Un file .dash è un testo breve, che si confronta e si revisiona come il codice. I commenti di revisione stanno in un file separato, `NAME.dash.comments.json`, che puoi escludere dal controllo di versione.

Correlati: [SQL per agenti IA](https://ducklocal.app/it/use-cases/ai-agent-sql/) · [Analisi dei dati locali](https://ducklocal.app/it/use-cases/local-data-analysis/) · [Interfaccia DuckDB](https://ducklocal.app/it/use-cases/duckdb-gui/) · [Interrogare un CSV con SQL](https://ducklocal.app/it/use-cases/query-csv-with-sql/)

## Apri la dashboard di esempio

Scarica DuckLocal, salva uno accanto all’altro i file `sales.csv` e `sales.dash` del tutorial e trascina la dashboard nella finestra.

## Link

- [Scarica DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Leggi la guida alle dashboard](https://ducklocal.app/docs/it/dashboards)
- [Vedi l’esempio completo](https://ducklocal.app/docs/it/dashboards#a-complete-example)

Fonte: https://ducklocal.app/it/use-cases/sql-dashboards/
