---
title: "Des tableaux de bord SQL locaux en fichiers texte | DuckLocal"
description: "Créez des tableaux de bord DuckDB sous forme de fichiers texte .dash : requêtes SQL, graphiques, cartes, indicateurs et filtres croisés qui tournent sur votre ordinateur, se relisent dans git et qu’un agent IA peut modifier et valider."
image: https://ducklocal.app/og-image.jpg?v=2
language: fr
---

# Des tableaux de bord SQL que l’on peut lire, comparer et relire

Un tableau de bord DuckLocal est un fichier texte `.dash` : des sources de données, des requêtes SQL DuckDB et les graphiques qui les dessinent. Il tourne sur votre ordinateur avec vos fichiers locaux, vit dans git comme du code et peut être écrit par vous ou par un agent IA.

Pas de serveur de BI, pas de compte, pas d’envoi de données. Gratuit et open source pour macOS, Windows et Linux.

- Fichiers texte .dash
- Graphiques, indicateurs, cartes, tableaux
- Filtrage croisé au clic
- Validé par ducklocal check

## 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.

[Tous les blocs et attributs](https://ducklocal.app/docs/fr/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
}
```

## Les graphiques dont un tableau de bord a besoin

Graphiques classiques, chiffres et cartes, disposés sur une grille de 12 colonnes.

- **line · area**Séries temporelles, jusqu’à 12 séries par graphique
- **bar · stacked_bar**Classements et répartitions, avec les totaux
- **scatter · histogram**Relations et distributions
- **heatmap**Jour de semaine par heure, région par mois
- **map**Points par latitude et longitude, dimensionnés et colorés
- **timeline**Des événements à leur vraie distance dans le temps, par couloirs
- **card**Un chiffre, avec son évolution, bonne ou mauvaise
- **table · text**Lignes triables, titres et notes
[Types de graphiques et options →](https://ducklocal.app/docs/fr/dashboards#plot-types)

## 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](https://ducklocal.app/docs/fr/dashboards#review-with-comments) · [Ce que Claude Dashboards m’a appris sur DuckLocal](https://ducklocal.app/fr/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
```

## 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.

[Valider un tableau de bord](https://ducklocal.app/docs/fr/dashboards#validate-a-dashboard)

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

> **Vous partez d’une seule requête ?** Tout résultat de l’éditeur SQL peut être mis en graphique sur-le-champ. Écrivez un fichier `.dash` quand un ensemble de graphiques vaut la peine d’être gardé. [Résultats et graphiques →](https://ducklocal.app/docs/fr/results-and-charts)

## 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 : `source` désigne des fichiers de données, `query` contient une instruction SQL DuckDB, `plot` dessine un résultat et `filter` fait 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 check` pour vérifier que chaque requête s’exécute et que les colonnes de chaque graphique existent, et répond aux commentaires de relecture avec `ducklocal 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.json` que vous pouvez exclure du contrôle de version.

À voir aussi : [SQL pour agents IA](https://ducklocal.app/fr/use-cases/ai-agent-sql/) · [Analyse de données locale](https://ducklocal.app/fr/use-cases/local-data-analysis/) · [Interface DuckDB](https://ducklocal.app/fr/use-cases/duckdb-gui/) · [Interroger un CSV avec SQL](https://ducklocal.app/fr/use-cases/query-csv-with-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.

## Liens

- [Télécharger DuckLocal](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [Lire le guide des tableaux de bord](https://ducklocal.app/docs/fr/dashboards)
- [Voir l’exemple complet](https://ducklocal.app/docs/fr/dashboards#a-complete-example)

Source: https://ducklocal.app/fr/use-cases/sql-dashboards/
