# Vos 10 premières minutes

> Un tutoriel DuckLocal de dix minutes avec un CSV d'exemple : l'interroger en SQL, graphiquer les résultats, les exporter et poser la même question depuis la CLI.

Source: https://ducklocal.app/docs/fr/tutorial

Une visite guidée : ouvrez un petit fichier de ventes, exécutez quelques
requêtes, graphiquez les réponses et exportez les résultats. Elle suppose
DuckLocal installé — sinon, commencez par [Démarrer](getting-started.md).

## 1. Récupérer le fichier d'exemple {#sample-file}

Téléchargez [sales.csv](https://ducklocal.app/docs/samples/sales.csv), qui contient deux semaines de
commandes fictives sur 224 lignes. Vous pouvez aussi le télécharger depuis le
terminal :

```bash
curl -LO https://ducklocal.app/docs/samples/sales.csv
```

Il a cinq colonnes :

| Colonne | Type | Exemple |
| --- | --- | --- |
| `date` | DATE | `2026-09-01` |
| `channel` | VARCHAR | `Web`, `Mobile app`, `Store`, `Phone` |
| `region` | VARCHAR | `North`, `South`, `East`, `West` |
| `orders` | BIGINT | `72` |
| `revenue` | DOUBLE | `4181.04` |

Vous n'avez rien eu à indiquer de tout cela à DuckLocal : DuckDB lit l'en-tête et
déduit les types tout seul.

## 2. L'ouvrir

Faites glisser `sales.csv` sur la fenêtre de DuckLocal. (Ou cliquez sur **Ouvrir
des fichiers…**, ou lancez `ducklocal sales.csv` si vous avez [ajouté la
commande](getting-started.md#add-command).)

Une notification confirme **Vue sales créée.** Dans la barre latérale,
**Fichiers locaux** liste maintenant `sales` avec ses 224 lignes ; dépliez-le
pour voir les colonnes et leurs types.

## 3. Regarder les lignes

Dans la barre latérale, cliquez sur le bouton de lecture à côté de `sales`.
L'éditeur se remplit d'un `SELECT * … LIMIT 100` pour cette vue — appuyez sur
**⌘↵** pour l'exécuter.

La grille sous l'éditeur affiche les lignes. Essayez la zone de filtre
au-dessus : tapez `Store` et appuyez sur Entrée pour ne garder que les lignes qui
le mentionnent. Le filtre agit sur les lignes déjà chargées et ne relance jamais
de requête.

## 4. Poser une question

Remplacez le SQL par ceci et appuyez sur **⌘↵** :

```sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

| channel | revenue |
| --- | --- |
| Mobile app | 290549.76 |
| Web | 289544.8 |
| Store | 240067.6 |
| Phone | 82511.2 |

Basculez maintenant le panneau de résultats de **Résultats** à **Graphique**.
Comme la première colonne est du texte, vous obtenez une barre par canal,
dimensionnée par la première colonne numérique.

::: tip Autocomplétion
Pendant la saisie, l'éditeur propose d'abord les noms de tables et de colonnes de
la barre latérale, puis les fonctions DuckDB et les mots-clés SQL — tapez `rev`
et `revenue` est la première suggestion.
:::

## 5. Graphiquer une tendance

Les graphiques sont dessinés à partir des lignes exactement telles que la requête
les renvoie : mettez donc le résultat en forme comme vous voulez le voir tracé.
Une colonne par canal donne une ligne par canal :

```sql
SELECT
  date,
  round(sum(revenue) FILTER (WHERE channel = 'Web'), 2)        AS web,
  round(sum(revenue) FILTER (WHERE channel = 'Mobile app'), 2) AS mobile,
  round(sum(revenue) FILTER (WHERE channel = 'Store'), 2)      AS store
FROM sales
GROUP BY date
ORDER BY date;
```

`FILTER (WHERE …)` n'agrège que les lignes correspondantes (syntaxe DuckDB).

Avec une date en première colonne, **Graphique** dessine un graphique en aires
dans le temps, une série par colonne numérique. [Résultats et
graphiques](results-and-charts.md) détaille les règles et les limites.

## 6. Exporter la réponse

**L'export écrase un fichier existant sans demander.** La tendance étant toujours
dans le panneau de résultats, cliquez sur **Exporter en CSV**. La boîte de
dialogue propose `~/Desktop/export.csv` ; changez le chemin si vous voulez, puis
confirmez.

L'export relance la requête, le fichier contient donc le résultat complet — pas
seulement ce qui est visible dans la grille.

## 7. Le retrouver demain

Ouvrez l'onglet **Historique** dans la barre latérale : chaque requête que vous
avez exécutée y est, y compris celles qui ont échoué. Cliquer sur une entrée
remplace le contenu actuel de l'éditeur — cliquez sur une entrée pour remettre
cette requête dans l'éditeur.

Quittez DuckLocal et relancez-le. `sales` est toujours sous **Fichiers locaux** :
les fichiers ouverts sont mémorisés par chemin et relus à chaque lancement, une
modification du CSV apparaît donc la prochaine fois que vous l'interrogez.

## 8. Bonus : la même question depuis un terminal

Si vous avez ajouté la commande `ducklocal`, la CLI répond sans ouvrir de
fenêtre — pratique pour les scripts et pour les agents IA :

```bash
ducklocal query --format md --sql "
  SELECT channel, round(sum(revenue), 2) AS revenue
  FROM 'sales.csv' GROUP BY channel ORDER BY revenue DESC"
```

Omettez `--format md` pour obtenir du JSON structuré. Le [guide de la CLI](cli.md)
et la compétence d'agent officielle — un paquet de compétences que les assistants
de codage IA peuvent appeler — sont le point de départ.

## Ensuite

- Essayez sur de vraies données : 3,5 millions de trajets de taxi, interrogés via HTTPS — voir [Exemple : trajets de taxi de New York](example-nyc-taxi.md)
- Pointez DuckLocal vers vos propres fichiers ou dossiers — voir [Sources de données](data-sources.md)
- Interrogez des fichiers dans un stockage compatible S3 — voir [S3 et httpfs](s3.md)
- Construisez un tableau de bord de requêtes enregistrées — voir [Tableaux de bord (.dash)](dashboards.md)
