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.
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 · areaSerie temporali, fino a 12 serie per grafico
- bar · stacked_barClassifiche e parti di un totale, con i totali
- scatter · histogramRelazioni e distribuzioni
- heatmapGiorno della settimana per ora, regione per mese
- mapPunti per latitudine e longitudine, con dimensione e colore
- timelineEventi alla loro reale distanza nel tempo, su corsie
- cardUn numero, con la sua variazione, buona o cattiva
- table · textRighe ordinabili, titoli e note
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 · Cosa mi hanno insegnato le Claude Dashboards su DuckLocal
$ 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.
- 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.
Domande sulle dashboard SQL
- Che cos’è un file .dash?
- Un file di testo che dichiara una dashboard come blocchi:
sourceindica i file di dati,querycontiene un’istruzione SQL di DuckDB,plotdisegna un risultato efilterfa 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 checkper confermare che ogni query funzioni e che le colonne di ogni grafico esistano, e risponde ai commenti di revisione conducklocal 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 · Analisi dei dati locali · Interfaccia DuckDB · Interrogare un CSV con 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.