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.

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

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

Terminal
$ 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

  • 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: 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.

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.