Vos 10 premières minutes
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.
1. Récupérer le fichier d'exemple
Téléchargez sales.csv, qui contient deux semaines de commandes fictives sur 224 lignes. Vous pouvez aussi le télécharger depuis le terminal :
curl -LO https://ducklocal.app/docs/samples/sales.csvIl 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.)
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 ⌘↵ :
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.
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 :
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 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 :
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 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
- Pointez DuckLocal vers vos propres fichiers ou dossiers — voir Sources de données
- Interrogez des fichiers dans un stockage compatible S3 — voir S3 et httpfs
- Construisez un tableau de bord de requêtes enregistrées — voir Tableaux de bord (.dash)
