Cookbook de patterns Datalog··5 recettes pour les power-users de mium
Et si les réponses aux questions récurrentes du coffre ne tenaient pas à un travail manuel laborieux, mais à cinq requêtes prêtes à copier que vous paramétrez une fois ? Le cookbook abaisse l'effort des évaluations standard — échéances ouvertes, nœuds centraux, piste d'audit, agrégation de tags, orphelins — de plusieurs minutes de recherche manuelle à une requête exécutée, sans nouveau logiciel et sans apprendre Datalog de fond en comble. Le prérequis est la discipline de propriétés, non un budget de licences.
- Sans discipline de propriétés et de namespace, les cinq recettes renvoient des ensembles vides au lieu de connaissance — le travail préalable sur le vocabulaire est un prérequis, non un effet secondaire.
- Les formats de date et de tags incohérents cassent les filtres en silence, sans message d'erreur — un silence fautif est plus dangereux qu'un arrêt bruyant.
- Le détecteur d'orphelins avec not-join passe mal à l'échelle — exécuté interactivement sur de grands coffres, il bloque la session au lieu de tourner la nuit.
Ce cookbook s'adresse aux power-users de mium et aux profils de développeurs qui ont déjà effleuré [[advanced-query-datalog]] et cherchent des exemples concrets, prêts à copier. Cinq recettes, chacune autonome — qui n'a besoin que du détecteur d'orphelins saute directement à la recette 5. Datalog lui-même est un langage de programmation logique des années 1970 ; Rich Hickey l'a redécouvert avec Datomic (Cognitect, depuis 2012) pour le travail quotidien des bases de données. mium utilise un dialecte Datalog pour interroger son propre index de blocs.
Recettes
Les cinq recettes sont indépendantes les unes des autres. Picorez ce dont vous avez besoin, ou lisez de façon linéaire — les deux ordres fonctionnent. Chaque recette a : un problème, une requête, optionnellement un encart sur le piège.
Recette 1··Tâches ouvertes avec échéance dans le trimestre courant
La question de sprint standard : quelles tâches sont ouvertes et doivent être livrées avant la fin du trimestre ? La requête filtre sur `frist::` dans la fenêtre Q et sur `status:: offen`, et renvoie le propriétaire.
[:find ?block ?frist ?owner
:where [?block :frist ?frist]
[?block :status "offen"]
[(>= ?frist "2026-04-01")]
[(<= ?frist "2026-06-30")]
[?block :owner ?owner]]Recette 2··Top 10 des hubs de backlinks
Quels blocs sont référencés le plus souvent ? Le top 10 par arêtes `:links-to` entrantes sont les nœuds centraux de votre coffre — souvent des termes, des personnes, des projets.
[:find (count ?backlink) ?target
:where [?backlink :links-to ?target]
:order-by [(count ?backlink) :desc]
:limit 10]Recette 3··Piste d'audit d'un bloc
Qui a changé quoi, et quand, sur un bloc ? La requête lit l'historique des transactions à l'envers pour un ID de bloc donné et renvoie `tx`, `attr`, `value` et le drapeau `added`.
[:find ?tx ?attr ?value ?added
:where [?block :db/id "<((uuid))>"]
[?tx :tx/affected-block ?block]
[?tx :tx/attr ?attr]
[?tx :tx/value ?value]
[?tx :tx/added ?added]]Recette 4··Agrégation de tags inter-coffres
À quelle fréquence chaque tag client apparaît-il à travers tous les coffres ? La requête groupe sur `tags::` avec le préfixe de namespace `#kunde-` et renvoie une liste de fréquences triée.
[:find (count ?block) ?tag
:where [?block :tags ?tag]
[(re-pattern "^#kunde-") ?tag]
:group-by ?tag
:order-by [(count ?block) :desc]]Recette 5··Détecteur de notes orphelines
Quelles notes n'ont aucun backlink entrant et ne sont pas archivées ? Ces orphelins sont les impasses du coffre — candidats au rangement, à la liaison ou à l'archivage.
[:find ?block ?title
:where [?block :title ?title]
[?block :archiv? false]
(not-join [?block]
[?other :links-to ?block])]Quand ces recettes ne conviennent PAS
Les requêtes Datalog ne sont pas un instrument universel. Trois situations dans lesquelles ces recettes ne tiennent pas :
- Recherche plein texte dans le contenu du bloc — Datalog filtre sur les propriétés et les arêtes, non sur la prose. Pour « trouver tout bloc contenant `Auftragsbestätigung` dans son texte », l'index plein texte de mium est le bon instrument, non une requête Datalog.
- Coffres très peu structurés, sans discipline de propriétés — les cinq recettes supposent toutes que `frist::`, `status::`, `owner::`, `tags::` sont entretenus de façon cohérente. Dans un coffre où 80 % des blocs ne portent aucune propriété, les requêtes renvoient des ensembles vides, non de la connaissance. La discipline de propriétés est un travail préalable, non un effet secondaire.
- Explorations ad hoc à la question floue — Datalog récompense les questions précises. Qui veut juste « voir un peu ce qu'il y a dans le coffre » va plus vite avec la vue graphe ou la navigation par backlinks qu'avec une requête qui reste encore à concevoir.
Une question honnête
Laquelle des cinq recettes a convenu chez vous, laquelle a tourné dans le vide ? Si vous en mettez une en production : qu'avez-vous paramétré autrement — fenêtre Q décalée, namespace de tags modifié, limite augmentée ? Et si aucune ne convient : à quel endroit avons-nous manqué la lacune ? Les recettes de cookbook vivent du frottement contre des coffres réels — vos retours sur la recette #6 qui manque ici sont les bienvenus. Pour aller plus loin dans cette vague : [[advanced-query-datalog]] pour les bases du langage, [[simple-query]] pour l'entrée plus douce sans syntaxe Datalog.