Gouvernance des données
Dictionnaire des données voyage : sens, unités et valeurs manquantes
Deux équipes peuvent utiliser le même champ pour des décisions différentes. Un dictionnaire doit expliquer son sens, son unité et les valeurs qu’il ne permet pas de conclure. La présence d’un type technique ne suffit pas à aligner vente, exploitation et reporting.
Ce que documentent les sources
Table Schema décrit les champs par nom, titre, description, type et format, avec des conventions possibles pour les valeurs manquantes.
Frictionless Data : Table Schema, version 1 — consulté le . Spécification Table Schema v1 consultée ; méthode de dictionnaire distincte d’une conformité implémentée ou d’un contrôle métier complet.
Nommer le champ et la décision qu’il soutient
Choisissez les informations qui changent une promesse ou un calcul : capacité, montant, état ou période. Conservez nom source, nom interne et définition compréhensible. Une colonne disponibilité peut décrire un résultat de recherche, une capacité physique ou un droit vendu. Ajoutez un exemple fictif et un contre-exemple pour montrer ce que le champ signifie dans votre contrat, avec le rôle chargé d’arbitrer une ambiguïté.
Décrire représentation, unité et absence
Reliez type, format, précision et unité au sens métier. Précisez la différence entre valeur absente, vide, zéro et non applicable lorsqu’elle existe. Une valeur manquante ne doit pas devenir un prix gratuit ou une confirmation par facilité de traitement. Les conventions de lecture doivent être comparées entre import, affichage et calcul ; le dictionnaire conserve les conversions autorisées et leurs limites.
Maintenir le sens avec les consommateurs
Listez les outils qui utilisent le champ et les versions qu’ils acceptent. Lors d’un changement, faites relire la définition et rejouer les exemples dans les consommateurs touchés. Une évolution de nom peut conserver le sens ; une évolution de sens peut casser un traitement sans changer le nom. La décision doit rendre visible ce qui est compris, refusé ou encore à clarifier avant diffusion.
Deux situations à rapprocher
Zéro et absence sont confondus
Scénario fictif : un champ vide est converti en zéro, puis présenté comme absence de frais. Faites retrouver la convention et suspendre cette conclusion tant que le sens manque.
La définition change sans renommage
Scénario fictif : une capacité passe de personnes à unités vendables. Les consommateurs doivent relire leur calcul même si la colonne porte le même nom.
Conserver la décision et sa prochaine suite
| Point | Preuve à retrouver | Contrôle proposé |
|---|---|---|
| Nom | Source et nom interne | Conserver la correspondance. |
| Sens | Définition et décision | Éviter une lecture par intuition. |
| Type | Format et représentation | Comparer les consommateurs. |
| Unité | Échelle et précision | Documenter les conversions. |
| Absence | Vide, zéro ou non applicable | Ne pas inventer une valeur métier. |
| Exemples | Cas fictif et contre-exemple | Rendre la définition vérifiable. |
| Responsable | Rôle d’arbitrage | Attribuer les ambiguïtés. |
| Évolution | Versions et consommateurs | Rejouer avant diffusion. |
Le dictionnaire est utile lorsqu’un champ peut être interprété de la même manière dans les décisions concernées. Les inconnues gardent un responsable. La définition et les exemples ne remplacent pas la validation technique ni la relecture du contenu réel.
Erreurs à éviter
- Décrire seulement le type technique.
- Transformer une absence en zéro sans convention.
- Oublier les consommateurs lors d’un changement de sens.
La fiche de contrôle permet de suivre les points à confirmer. Le registre associé conserve le périmètre, les preuves et la décision ; ses champs peuvent être remplis dans l’atelier avec des données fictives ou anonymisées.
Nommer les points du dossier
- Définition d’un champ de décision : Sens documenté qui précise les conclusions autorisées par une valeur.
- Convention d’absence d’un champ : Règle distinguant valeur manquante et autres valeurs du contrat.
- Contre-exemple de dictionnaire : Cas fictif montrant une interprétation qui doit être refusée.
- Arbitrage du sens d’une donnée : Décision attribuée pour résoudre des lectures incompatibles d’un champ.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- Frictionless Data : Table Schema, version 1 — Spécification Table Schema v1 consultée ; méthode de dictionnaire distincte d’une conformité implémentée ou d’un contrôle métier complet. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Un schéma technique remplace-t-il le dictionnaire ?
Il peut décrire la forme ; le sens, l’unité et les décisions autorisées doivent aussi être compris.
Quels champs traiter d’abord ?
Ceux dont une ambiguïté affecte la vente, l’exploitation ou les calculs utiles.
Que faire d’une définition incertaine ?
Conservez les lectures possibles et attribuez l’arbitrage avant diffusion.