Aller au contenu

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 :

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

Il a cinq colonnes :

ColonneTypeExemple
dateDATE2026-09-01
channelVARCHARWeb, Mobile app, Store, Phone
regionVARCHARNorth, South, East, West
ordersBIGINT72
revenueDOUBLE4181.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 ⌘↵ :

sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
channelrevenue
Mobile app290549.76
Web289544.8
Store240067.6
Phone82511.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 :

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

Publié sous licence Apache-2.0.