Un tableau de bord est un fichier court
Les blocs source désignent les fichiers de données, les blocs query contiennent le SQL et les blocs plot disent comment dessiner chaque résultat. Un bloc filter fait qu’un clic sur un graphique filtre les autres. Pas de fonctions ni de gabarits à apprendre : du SQL et quelques attributs.
Les chemins sont relatifs au fichier .dash : un dossier contenant la spécification et ses données fonctionne où que vous le copiiez.
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 }
Les graphiques dont un tableau de bord a besoin
Graphiques classiques, chiffres et cartes, disposés sur une grille de 12 colonnes.
- line · areaSéries temporelles, jusqu’à 12 séries par graphique
- bar · stacked_barClassements et répartitions, avec les totaux
- scatter · histogramRelations et distributions
- heatmapJour de semaine par heure, région par mois
- mapPoints par latitude et longitude, dimensionnés et colorés
- timelineDes événements à leur vraie distance dans le temps, par couloirs
- cardUn chiffre, avec son évolution, bonne ou mauvaise
- table · textLignes triables, titres et notes
Relire un tableau de bord comme un document
Survolez un graphique, cliquez sur la bulle et écrivez ce qui doit changer, par exemple « classe-les, le plus gros canal en premier ». Les fils acceptent des réponses et peuvent être résolus, et un graphique avec des fils ouverts en affiche le nombre.
Un agent IA lit les mêmes fils avec ducklocal comments. Chaque fil indique son graphique et les lignes de son bloc dans le fichier. L’agent modifie la spécification, la valide et répond. La fenêtre ouverte se redessine en moins d’une seconde et affiche la réponse, marquée Agent.
Relire avec des commentaires · Ce que Claude Dashboards m’a appris sur 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
Vérifié avant que quiconque l’ouvre
ducklocal check analyse le fichier, résout chaque référence et exécute chaque requête en lecture seule. Il vérifie ensuite que les colonnes de chaque graphique existent dans le vrai résultat : une faute de frappe, une conversion qui échoue ou un glob qui ne trouve rien se voient dans le terminal, pas en réunion.
Tous les problèmes sont listés d’un coup, un file:line: message chacun, avec des codes de sortie exploitables par un script ou une CI.
- Syntaxe, noms et références vérifiés
- Le SQL de chaque requête passé dans DuckDB
- Colonnes des graphiques comparées aux vrais résultats
- Filtres vérifiés avec une valeur choisie
- Requêtes sans résultat signalées
Vos données restent locales, le fichier voyage
Les requêtes tournent dans le moteur DuckDB intégré à DuckLocal, sur les fichiers de votre disque ou une base DuckDB. Envoyez le dossier à quelqu’un : il voit le même tableau de bord sur sa copie des données, sans rien publier ni partager d’espace de travail.
Questions sur les tableaux de bord SQL
- Qu’est-ce qu’un fichier .dash ?
- Un fichier texte qui déclare un tableau de bord sous forme de blocs :
sourcedésigne des fichiers de données,querycontient une instruction SQL DuckDB,plotdessine un résultat etfilterfait qu’un clic sur un graphique filtre les autres. Aucun code à écrire. - Faut-il un serveur ou un compte de BI ?
- Non. DuckLocal ouvre le fichier et exécute ses requêtes avec le moteur DuckDB intégré à l’application, sur votre ordinateur. Les fichiers de données restent où ils sont.
- Quels graphiques sont disponibles ?
- Courbes, barres, barres empilées, aires, nuages de points, secteurs, cartes de chaleur, histogrammes, cartes géographiques et frises chronologiques, plus des tableaux, des indicateurs chiffrés avec leur évolution et des panneaux de texte, sur une grille de 12 colonnes.
- Un agent IA peut-il créer ou modifier un tableau de bord ?
- Oui. Un agent écrit ou modifie le fichier .dash, lance
ducklocal checkpour vérifier que chaque requête s’exécute et que les colonnes de chaque graphique existent, et répond aux commentaires de relecture avecducklocal comments. La fenêtre ouverte se redessine en moins d’une seconde. - Puis-je garder mes tableaux de bord dans git ?
- Oui. Un fichier .dash est un texte court, qui se compare et se relit comme du code. Les commentaires de relecture vivent dans un fichier séparé
NAME.dash.comments.jsonque vous pouvez exclure du contrôle de version.
À voir aussi : SQL pour agents IA · Analyse de données locale · Interface DuckDB · Interroger un CSV avec SQL
Ouvrir le tableau de bord d’exemple
Téléchargez DuckLocal, enregistrez côte à côte les fichiers sales.csv et sales.dash du tutoriel, puis déposez le tableau de bord sur la fenêtre.