Code transformé en nombre
Préservez le code exact et testez que le chargement ne supprime pas les zéros initiaux.
Guides pratiques approfondis
Décrire grain, colonnes, types, unités, valeurs manquantes et clés avant tout calcul ou jointure.
Mise à jour :

Illustration générée par IA
Un intitulé de colonne ne suffit pas à comprendre un fichier. Le dictionnaire lie chaque champ à une définition, un domaine de valeurs et une version du schéma. Il doit distinguer le jeu de données de ses distributions, par exemple CSV et API.
Écrivez l’objet observé, le territoire et la période : une entreprise-année n’est pas un établissement-mois. Indiquez la clé unique attendue et les relations avec les autres tables.
Pour chaque colonne, renseignez nom exact, définition, type logique, format, unité, liste de codes, nullabilité et origine. Gardez les identifiants avec zéros initiaux en texte.
Testez unicité, domaines et champs obligatoires sur le fichier réel. Une chaîne vide, « non applicable » et zéro ont des sens différents. Datez les changements de définition, de code ou de type.
Atelier de lecture
Le contrat DEMO décrit une ligne par dossier. Les règles sont inventées pour l’exercice et ne définissent aucun registre réel.
Données et traces fictives pour apprendre : aucun résultat présenté ici ne provient d’un service interrogé en direct.
La distribution étudiée est JSON : record_id est une chaîne de quatre chiffres, state vaut OPEN ou CLOSED, amount est un nombre décimal ou null. La clé record_id doit être unique. La casse et les types font partie du contrat.
Si le tableau dépasse l’écran, faites-le défiler horizontalement ; les flèches du clavier fonctionnent lorsque la zone est sélectionnée.
| Champ ou règle | Valeur testée | Lecture contractuelle | Action |
|---|---|---|---|
| record_id : texte | "0042" ; nombre 42 | La chaîne est admise ; le nombre ne respecte pas le type | Rejeter 42 sans inventer ses zéros. |
| state : code exact | OPEN ; open | OPEN est admis ; open est hors domaine | Ne pas convertir la casse sans règle validée. |
| amount : nombre ou null | 12.5 ; "12.5" ; null ; "" | Le nombre et null sont admis ; les deux chaînes sont rejetées | null signifie inconnu ; jamais zéro par défaut. |
| Unicité de record_id | Deux lignes portant "0042" | La clé se répète, même si les montants diffèrent | Bloquer la sortie à valider et demander le grain correct. |
Ouvrir chaque proposition pour comparer son diagnostic. Plusieurs contrôles peuvent rester nécessaires.
Non. Cela efface les anomalies et ajoute des hypothèses absentes du contrat.
Oui. Séparer erreurs de type, codes hors domaine et clé répétée. Résoudre avec la documentation ou le producteur.
Non. Ce contrat JSON les distingue. Un CSV peut avoir une autre règle, qui doit être documentée séparément.
Contrat : DEMO, une ligne par dossier, JSON record_id : texte de quatre chiffres, clé unique state : OPEN ou CLOSED, casse exacte amount : nombre décimal ou null ; null=inconnu Anomalies : type, code, chaîne vide, clé répétée Décision : données brutes conservées, sortie non validée
La syntaxe présentée résume un contrat pédagogique, pas un schéma exécutable complet. Les validations ne sont pas effectuées sur un fichier de l’utilisateur.
Préservez le code exact et testez que le chargement ne supprime pas les zéros initiaux.
Identifiez devise, échelle et période avant toute somme ; ne déduisez pas l’unité de l’ordre de grandeur.
Lecture guidée d’un extrait
Dans cet exemple fictif, une ligne décrit un site pour une année. Le dictionnaire ci-dessous fixe les règles de lecture ; les données contiennent volontairement une anomalie.
Exercice fictif : les identifiants, valeurs et dates illustrent le contrôle. Cet extrait n’est pas une réponse collectée en direct.
La paire site_id et year doit être unique. Le même site peut apparaître sur plusieurs années.
site_id est un texte de trois chiffres. amount_kEUR est un montant annuel en milliers d’euros ; une cellule vide signifie non renseigné.
Comparer les paires de clés, conserver les zéros initiaux et distinguer montant nul et montant inconnu avant toute agrégation.
site_id,year,amount_kEUR
007,2024,
007,2025,0
007,2025,12.5
site_id : string; pattern = ^[0-9]{3}$; required
year : integer; required
amount_kEUR : decimal; unit = 1000 EUR; empty = unknown
key : (site_id, year); uniqueNon. Il faut d’abord résoudre la clé dupliquée avec le producteur et définir le traitement des valeurs manquantes. Additionner les seules valeurs connues masquerait la ligne inconnue et pourrait compter deux fois le même site-année. Conserver les lignes originales et documenter la décision.
Références officielles : W3C — Model for Tabular Data and Metadata on the Web
Exercice corrigé
Exemple fictif : les valeurs et documents servent à apprendre la méthode, sans décrire un organisme réel.
Le producteur décrit amount en milliers d’euros, arrondis au dixième. Le dictionnaire interne mentionne seulement « nombre » ; les montants bruts ne sont pas fournis.
Si le tableau dépasse l’écran, faites-le défiler horizontalement ; les flèches du clavier fonctionnent lorsque la zone est sélectionnée.
| Ligne | amount |
|---|---|
| A | 1.2 |
| B | 2.5 |
La somme des valeurs publiées est 3.7 milliers d’euros, soit 3 700 euros. Écrire 3.70 ne crée pas une précision supplémentaire. Documenter le champ comme montant en milliers d’euros, et préciser que la somme provient de valeurs arrondies plutôt que de montants exacts connus.
Si le producteur donne des montants bruts non arrondis, les calculer séparément et identifier leur version. Ajouter un cas d’absence au jeu fictif : amount=0 désigne un montant nul connu, tandis qu’une cellule déclarée inconnue ne donne aucun montant. Documenter le code d’absence et vérifier qu’un import ne le convertit pas silencieusement en zéro avant l’agrégation.
Garder définition, unité, échelle, précision, codes d’absence et exemple valide.
Référence documentaire : W3C — CSV on the Web: A Primer · Consultée le
REPÈRES DOCUMENTÉS
La RFC 6901 définit une adresse à l’intérieur d’un document JSON. Le pointeur n’est ni une requête JSONPath ni une opération de modification. Le lecteur ci-dessous utilise un petit document pédagogique créé pour cette page : ses valeurs ne représentent pas des observations réelles. Il permet de distinguer valeur trouvée, chemin inexistant et syntaxe invalide.
| Repère | Valeur ou forme | Ce que cela désigne |
|---|---|---|
| "" | Root value | La chaîne vide désigne le document entier. Elle ne signifie pas « aucun résultat » ; un champ de saisie vide peut donc constituer une adresse correcte. |
| / | Empty member name | Un slash seul adresse la propriété dont le nom est la chaîne vide, si elle existe. Ce cas est différent de la racine et doit rester distinct pendant le contrôle. |
| ~1 | / inside member name | Dans un nom de propriété, le slash s’écrit ~1 pour ne pas être interprété comme un séparateur de chemin. Une propriété a/b n’est pas la même structure que a contenant b. |
| ~0 | ~ inside member name | Un tilde s’écrit ~0. Décoder ~1 avant ~0 évite de transformer à tort ~01 en slash : cette séquence désigne le nom littéral ~1. |
| /items/0 | Zero-based array index | Le premier élément d’un tableau porte l’indice zéro. L’indice doit être entier, positif ou nul, et sans zéro initial superflu. |
| /items/01 | Invalid array index | 01 n’est pas un indice de tableau admis, mais peut être le nom exact d’une propriété d’objet. Le sens dépend donc du type de la valeur traversée. |
| /items/- | No existing array member | Dans un tableau, le tiret désigne une position après le dernier élément, qui n’existe pas pour une simple lecture. Ne pas y appliquer automatiquement une convention d’ajout d’un autre protocole. |
| #/a~1b | URI-fragment form | La forme fragment URI commence par # et applique aussi le décodage URI. Un pourcentage littéral dans cette forme doit être encodé ; ne pas appliquer ce décodage à la forme texte ordinaire. |
Document inventé pour l’exercice : ces nombres ne sont pas des observations. Le pointeur est lu localement, sans requête ni modification du document.
{
"items": [
{
"id": "A",
"count": 0,
"note": null
},
{
"id": "B",
"count": 3,
"note": ""
}
],
"a/b": {
"m~n": true
},
"": false,
"01": "code",
"é": "accent",
"~1": "literal",
"c%d": "percent"
}Exemple initial : /items/0/count donne 0 ; /items/0/note donne null ; /items/1/note donne une chaîne vide ; / donne false.
Valeur trouvée · nombre
0Le nom des propriétés reste exact : les espaces ne sont pas supprimés et les accents ne sont pas normalisés. Ce lecteur n’ajoute aucun élément au document et ne traite pas JSONPath.
Le lecteur compare les noms exactement, sans corriger accents, casse ou espaces. Il ne remplace pas null, false, zéro ou chaîne vide par une valeur manquante. Un pointeur valide peut néanmoins ne rien résoudre dans ce document ; conserver cette différence plutôt que fabriquer un zéro. Les clés du document et la syntaxe du pointeur restent indépendantes de la langue de l’interface.
La propriété note existe et porte explicitement null dans l’exemple. Un chemin vers une propriété absente ne trouve aucune valeur. Ces deux situations peuvent avoir des conséquences différentes pour une jointure ou une conversion de tableau.
Documentation consultée le .
REPÈRES DOCUMENTÉS
La RFC 8259 décrit une syntaxe d’échange, mais ne garantit pas une représentation arbitrairement précise dans chaque logiciel. Un identifiant numérique trop long peut être altéré lors de la lecture avant même un affichage dans un tableur. Les exemples de formes ci-dessous sont pédagogiques, sans valeur d’identifiant attribué.
| Repère | Valeur ou forme | Ce que cela désigne |
|---|---|---|
| Integer interoperability | −9007199254740991 … 9007199254740991 | La RFC repère cette plage entière comme interopérable entre implémentations utilisant la précision courante binary64. Elle donne une garantie commune, pas une limite syntaxique universelle de JSON. |
| Beyond 2^53 − 1 | binary64 · 2^53 + 1 | Hors de la plage commune, certains entiers restent exacts, mais tous les entiers consécutifs ne sont plus distinguables en binary64. Ne pas affirmer que chaque nombre plus grand est faux ; vérifier le type réellement employé par le lecteur. |
| "00123" / 123 | "00123" ≠ 123 | La première forme est une chaîne et garde ses zéros initiaux. La seconde est un nombre. Un numéro de dossier ou un code n’est pas une quantité à additionner ; définir le type texte dans le contrat évite des conversions involontaires. |
| NaN / Infinity | JSON: ✗ | Ces deux mots ne sont pas des valeurs numériques permises par la grammaire JSON. Un outil qui les accepte peut utiliser une extension ; sa réussite ne démontre pas une compatibilité stricte avec un autre système. |
| Duplicate object names | SHOULD | Les noms d’un objet devraient être uniques. Sinon, des lecteurs gardent la dernière valeur, d’autres signalent une erreur ou exposent toutes les paires. Le nombre de clés après lecture peut donc masquer une collision dans le texte source. |
| Network exchange | UTF-8 · RFC 8259 §8.1 | L’échange hors d’un écosystème fermé doit employer UTF-8. Corriger un encodage et conserver de grands nombres exacts sont deux problèmes différents : un JSON UTF-8 correctement décodé peut encore subir un arrondi. |
Fixer types et précision avant lecture. Convertir en chaîne un nombre déjà arrondi ne restaure pas l’identifiant initial. Si des noms répétés sont interdits dans le contrat, les détecter avant qu’un parseur les écrase. Garder le document source pour distinguer une erreur de transmission d’une conversion locale.
Non. Une lecture dans des nombres JavaScript peut déjà avoir perdu des chiffres, et une clé répétée peut avoir été remplacée. Une validation du contrat doit traiter ces risques sur la représentation source, pas seulement sur l’objet obtenu.
Documentation consultée le .
Non : un exemple illustre une valeur ; la définition fixe toutes les valeurs admissibles.
Documentez le schéma commun et les différences de distribution : noms, formats et règles de null.
Chercher la documentation et conserver l’incertitude. Les valeurs observées peuvent aider à formuler une hypothèse, mais ne suffisent pas toujours à confirmer le sens ni les opérations pertinentes.
OUTILS / REGISTRES
Testez unicité, domaines et champs obligatoires sur le fichier réel. Une chaîne vide, « non applicable » et zéro ont des sens différents. Datez les changements de définition, de code ou de type.
REPÈRES DOCUMENTÉS
Une colonne appelée id n’est pas automatiquement une clé primaire. Les garanties viennent de contraintes effectives, de leur portée et de leur validation. Ces règles sont documentées pour PostgreSQL 18 ; d’autres systèmes peuvent traiter les NULL d’une contrainte unique différemment.
| Repère | Valeur ou forme | Ce que cela désigne |
|---|---|---|
| PRIMARY KEY (a) | Unique et non nul | La clé primaire simple exige une valeur non nulle et unique dans la table. Elle ne certifie pas que le code désigne la bonne entité dans le monde réel ou qu’il soit stable dans le temps. |
| UNIQUE (a) | NULL distincts par défaut | Par défaut dans PostgreSQL, plusieurs NULL peuvent coexister sous une contrainte unique simple. Un test d’unicité seul n’est donc pas un test de complétude de la colonne. |
| UNIQUE NULLS NOT DISTINCT (a) | Au plus un NULL dans cette colonne | Cette variante traite les NULL comme non distincts pour l’unicité. Sur la seule colonne a, elle empêche plusieurs NULL, mais ne rend pas la colonne obligatoire : une absence reste possible. |
| PRIMARY KEY (a, b) | Couple unique · composantes non nulles | C’est le couple qui est unique, pas nécessairement chacune de ses composantes. Ne pas supprimer b d’une jointure sous prétexte que a appartient à une clé primaire composite. |
| FOREIGN KEY · MATCH SIMPLE | Un NULL peut dispenser la référence | Avec le comportement simple d’une clé étrangère composite, un NULL dans une composante peut dispenser la ligne de trouver une référence. L’existence d’une déclaration de clé étrangère ne suffit donc pas à affirmer que toutes les lignes ont un parent. |
| FOREIGN KEY · MATCH FULL | Seuls tous NULL dispensent la référence | MATCH FULL ne dispense la ligne que lorsque toutes les composantes sont NULL ; un mélange de valeurs et de NULL échoue. Ajouter NOT NULL si toute ligne doit obligatoirement posséder une référence complète. |
| CHECK (x > 0) | Vrai ou inconnu satisfait le contrôle | Le contrôle est satisfait si son expression est vraie ou inconnue. Une valeur x manquante peut donc passer CHECK (x > 0). Exiger simultanément la présence demande une contrainte NOT NULL distincte. |
Tableau JSON de 0 à 50 lignes ; chaque ligne contient 1 à 3 composantes, toujours le même nombre. Une composante est une chaîne de 64 points de code au plus ou null. Les deux tables d’une jointure doivent avoir la même largeur. Maximum 20 000 caractères JSON par champ. Une chaîne vide reste une valeur, distincte de null.
Exemples pédagogiques et calcul local, sans requête à une base et sans envoi des saisies. Comparaison sensible à la casse, sans suppression d’espaces, normalisation Unicode ni conversion de type. Les résultats décrivent seulement les lignes saisies ; ils ne certifient pas les contraintes d’une base réelle.
Exemple pédagogique calculé ; modifiez les saisies puis examinez-les.
| Jeu de clés | UNIQUE | UNIQUE NULLS NOT DISTINCT | PRIMARY KEY |
|---|---|---|---|
| [["001"],["002"]] | Compatible avec cette politique | Compatible avec cette politique | Compatible avec cette politique |
| [["001"],["001"]] | Incompatible avec cette politique | Incompatible avec cette politique | Incompatible avec cette politique |
| [[null]] | Compatible avec cette politique | Compatible avec cette politique | Incompatible avec cette politique |
| [[null],[null]] | Compatible avec cette politique | Incompatible avec cette politique | Incompatible avec cette politique |
| [["FR",null],["FR",null]] | Compatible avec cette politique | Incompatible avec cette politique | Incompatible avec cette politique |
| [["FR","001"],["FI","001"]] | Compatible avec cette politique | Compatible avec cette politique | Compatible avec cette politique |
{
"keys": [
[
null
],
[
null
]
]
}Une clé étrangère n’impose pas, à elle seule, une relation un-à-un : plusieurs enfants peuvent référencer le même parent. Avant de joindre, relever les colonnes exactes, la politique NULL et les contraintes réellement vérifiées. Un export CSV ne transporte pas automatiquement ces garanties de la base source.
Non. Elle décrit une portée et un traitement des valeurs absentes dans une base donnée. L’export peut avoir changé de granularité, concaténé des millésimes ou perdu une composante de clé ; contrôler ces dimensions avant de supprimer des lignes.
Documentation consultée le .
APPROFONDISSEMENT / PRATIQUE
Une table contient des noms de colonnes courts et des codes difficiles à interpréter. Le dictionnaire doit donner une définition utilisable et conserver les ambiguïtés non résolues.
Mis à jour le .
Documenter nom, type, unité, modalités, valeurs manquantes et exemples. Identifier les clés et les champs dont le sens dépend d’une autre variable.
Un type numérique ne signifie pas que l’on peut additionner les valeurs. Un code peut représenter une catégorie, un identifiant ou une valeur absente.
Le dictionnaire relie champ original, définition, règles de lecture et source documentaire. Les hypothèses sont séparées des définitions confirmées.