Chapitre 05
Dataview : interroger ses propres notes

1. L'idée

Dataview lit le front-matter de toutes les notes du vault et t'en donne une vue de base de données. Tu écris une requête dans un bloc de code, et Obsidian affiche le résultat, recalculé à chaque ouverture de la note.

C'est le pendant du chapitre 3 : le front-matter est le contrat, Dataview est le moteur qui l'exploite. Sans lui, un vault plat n'est qu'un tas de fichiers ; avec lui, le classement se reconstruit à la demande, sous autant d'angles que tu veux.

```dataview
TABLE status, repo, updated
FROM "30-projets"
WHERE type = "project" AND status = "active"
SORT updated DESC
```

2. Les quatre formes de requête

LIST
FROM "20-notes"
WHERE type = "concept"
SORT file.name ASC

TABLE WITHOUT ID file.link AS Note, updated AS "Dernière touche"
FROM "20-notes"
LIMIT 10

TASK
FROM "30-projets"
WHERE !completed

WITHOUT ID supprime la première colonne, ajoutée d'office, qui contient le lien vers la note. À utiliser dès que tu veux maîtriser tes colonnes, comme ci-dessus où le lien est remis à la main sous un nom choisi.

3. Choisir la source

FROM restreint l'ensemble de départ. Sans lui, la requête porte sur tout le vault.

FROM "30-projets"                -- un dossier (guillemets obligatoires)
FROM #safety                      -- une étiquette
FROM [[profinet]]                 -- les notes qui pointent VERS cette note
FROM outgoing([[profinet]])       -- les notes QUE cette note cite
FROM "20-notes" AND #safety       -- combinaisons avec AND / OR / -
FROM "20-notes" AND -#à-trier

4. Les champs implicites

Au-delà de ton front-matter, Dataview expose sur chaque note un objet file que tu n'as rien eu à remplir :

Les champs en ligne

Dataview lit aussi des champs posés dans le corps de la note, avec un double deux-points :

Mesure effectuée le terrain. duree:: 45min
- [ ] Reprendre l'essai [échéance:: 2026-09-01]

Pratique pour annoter une ligne précise. À utiliser avec parcimonie : ces champs échappent au front-matter, donc au contrat du chapitre 3, donc au validateur.

5. Filtrer, trier, limiter

WHERE type = "project" AND status != "closed"
WHERE contains(tags, "safety")
WHERE created >= date(2026-01-01)
WHERE length(file.inlinks) = 0
WHERE contains(projects, this.file.link)

SORT updated DESC, file.name ASC
LIMIT 20

this désigne la note qui contient la requête. C'est ce qui permet d'écrire une requête générique dans un template : la même ligne, recopiée dans chaque fiche projet, donne à chaque fois le bon résultat.

Les fonctions les plus utiles : contains(liste, valeur), length(liste), date(…) et dur(…), choice(test, si_vrai, si_faux), filter(), map(), sum(), round().

6. Grouper — et le piège

GROUP BY regroupe les résultats par la valeur d'une expression. Et il change ce qui est visible à partir de là, ce que la documentation ne crie pas assez fort.

TABLE repo, updated
FROM "30-projets"
WHERE type = "project"
GROUP BY status

Cette requête s'affiche sans erreur, avec les bons groupes… et deux colonnes intégralement vides.

TABLE rows.file.link AS Projet, rows.repo, rows.updated
FROM "30-projets"
WHERE type = "project"
GROUP BY status

FLATTEN fait l'inverse : il déplie une liste pour produire une ligne par élément. Utile pour éclater les étiquettes ou les liens d'une note.

TABLE file.link
FROM "10-journal"
FLATTEN projects AS project
WHERE project = this.file.link

7. Les trois vues du vault de référence

Tableau de bord

TABLE status, repo, updated
FROM "30-projets"
WHERE type = "project" AND status = "active"
SORT updated DESC

Complété par la liste de l'inbox à trier et, via le plugin Tasks, les tâches en retard.

Concepts orphelins

LIST
FROM "20-notes"
WHERE type = "concept"
  AND length(file.inlinks) = 0
  AND (!see_also OR length(see_also) = 0)
SORT file.name ASC

C'est le détecteur de base de connaissance qui pourrit : une fiche que rien ne cite et qui ne cite rien ne sera jamais relue. La double condition couvre les deux formes d'absence — champ inexistant, et champ présent mais vide.

8. Dataview JS, et quand s'arrêter

Dataview offre aussi un mode JavaScript, dataviewjs, où tu construis le rendu à la main. Il permet tout, y compris des choses qu'on regrette.

Récapitulatif

Exercices

TABLE WITHOUT ID file.link AS Fiche,
      updated AS "Mise à jour",
      length(file.inlinks) AS Citations
FROM "20-notes"
WHERE type = "concept" AND updated >= date(2026-07-01)
SORT length(file.inlinks) DESC

TABLE title, created
FROM "20-notes"
GROUP BY type

TABLE rows.file.link AS Note, rows.title, rows.created
FROM "20-notes"
GROUP BY type

TABLE WITHOUT ID file.link AS Jour, project AS Projet
FROM "10-journal"
FLATTEN projects AS project
WHERE project AND project.status = "closed"
SORT file.name DESC