Millésimes et version du schéma
Deux repères distincts décrivent une publication de la BDNB : le millésime des données et la version du schéma. Le premier identifie le contenu et sa borne temporelle ; la seconde décrit l’organisation des tables et des colonnes.
- Le millésime majeur, par exemple
2026_02, correspond à une nouvelle production du socle de la BDNB, liée à l’actualisation de la BD TOPO et des Fichiers fonciers. - Sa date indique l’arrêt initial de l’intégration de nouvelles données sources pour la production du millésime majeur.
- La lettre, par exemple
.bdans2026_02.b, identifie le millésime mineur : une révision qui peut mettre à jour des sources ou ajouter des prédictions, et repousser la date d’intégration des sources. - La version du schéma, par exemple
0.7, décrit la structure des données. Elle est indépendante du millésime. - Pour identifier les données utilisées dans une analyse, conserver le millésime complet, lettre comprise, et la version du schéma.
Lire un nom de livraison
Dans l’exemple 2026_02.b, schéma 0.7, chaque partie a un rôle différent :
| Repère | Signification | Ce qu’il ne faut pas en déduire |
|---|---|---|
2026_02 |
Millésime majeur : arrêt initial de l’intégration des nouvelles données sources en février 2026. | Ce n’est ni la date de publication de la BDNB, ni la date d’observation de toutes les sources. |
.b |
Millésime mineur : révision du contenu qui peut repousser la date d’intégration des sources. | La date du millésime majeur ne suffit plus à connaître la fraîcheur de toutes les sources. |
0.7 |
Version du schéma : organisation des tables, colonnes et relations. | Ce n’est pas une date et ce n’est pas le millésime des données. |
Les noms de millésimes peuvent aussi être présentés avec un tiret : 2026-02.b désigne le même millésime que 2026_02.b.
Le millésime majeur : renouveler le socle de la BDNB
La BD TOPO de l’IGN apporte les géométries des constructions. Les Fichiers fonciers de la DGFiP, retraités par le Cerema, apportent les informations sur les locaux et les bâtiments fiscaux. Leur croisement constitue le socle de l’identification des bâtiments groupes.
Un nouveau millésime majeur accompagne une nouvelle production de ce socle, liée à la mise à jour de ces sources structurantes. Les constructions disponibles, les locaux décrits et leurs appariements peuvent donc évoluer d’un millésime majeur à l’autre.
Le changelog du millésime 2026-02.a illustre ce renouvellement : son tableau des sources indique notamment les Fichiers fonciers 2025 et la BD TOPO de décembre 2025.
La date du millésime majeur correspond à la date d’arrêt initial de l’intégration de nouvelles données sources pour cette production. Une révision mineure peut ensuite repousser cette date d’intégration sans changer le nom du millésime majeur.
Cette date ne signifie pas que toutes les sources décrivent le parc bâti au même instant. Chaque jeu de données conserve sa propre date d’observation, son rythme de mise à jour et son délai de diffusion. Une source intégrée avant la date d’arrêt peut ainsi décrire une situation plus ancienne.
La publication de la BDNB peut intervenir après cette date, une fois les traitements et les contrôles réalisés. La date de publication ne modifie pas la borne temporelle des sources ; c’est une nouvelle intégration de données, notamment lors d’une révision mineure, qui peut la repousser.
Le millésime mineur : réviser ou enrichir le contenu
La lettre placée après la date identifie le millésime mineur : .a, .b, .c, etc. Le passage de 2026_02.a à 2026_02.b indique une révision au sein du millésime majeur 2026_02.
Une révision mineure peut notamment :
- mettre à jour des données issues d’une source, y compris avec une version plus récente que la date du millésime majeur ;
- corriger des données ou des résultats de traitement ;
- ajouter ou recalculer des prédictions à partir des données retenues pour ce millésime.
Une révision mineure peut repousser la date d’intégration. Des sources postérieures à février 2026 peuvent donc être intégrées à 2026_02.b. L’ajout d’une prédiction n’implique toutefois pas nécessairement de nouvelles sources : la date du calcul et la date des sources restent deux informations différentes.
Deux millésimes mineurs peuvent donc fournir des résultats différents, même s’ils partagent le même millésime majeur. La lettre fait partie de l’identification de la publication et doit être conservée pour reproduire une analyse.
Le changelog du millésime 2026-02.b donne des exemples de révisions mineures : actualisation des DPE, de SIRENE et de SITADEL, ajout des audits énergétiques et évolution des simulations DPE et de l’indicateur de surchauffe des bâtiments.
Ainsi, le changelog de 2026-02.b indique SIRENE et SITADEL d’août 2026, ainsi que les DPE de septembre 2026. Ces actualisations illustrent le report de la date d’intégration au sein d’un même millésime majeur.
La version du schéma : décrit la structure, pas la fraîcheur
La version du schéma, par exemple 0.7, concerne le modèle de données : les tables disponibles, les noms et types de colonnes, ainsi que les relations entre objets.
Le schéma SQL publié avec SchemaSpy permet de consulter les tables, les colonnes et les relations de la livraison documentée. Le lien latest évolue : vérifier le millésime et la version du schéma affichés avant de les utiliser pour une extraction plus ancienne.
Deux schémas de production y sont documentés :
| Schéma de production | Contenu |
|---|---|
bdnb_v07 |
Données de la BDNB : bâtiments, relations, données sources rattachées et indicateurs. |
bdnb_v07_refadmin |
Référentiel administratif cohérent avec le millésime de la BDNB : IRIS, communes, EPCI, départements et régions. |
Ces noms de schémas PostgreSQL désignent deux ensembles de tables, pas deux millésimes différents. Le suffixe v07 n’indique pas la fraîcheur des données.
La version du schéma répond à une question différente de celle du millésime :
| Question | Repère à consulter |
|---|---|
| Quel contenu et quelle borne temporelle sont utilisés ? | Le millésime complet, par exemple 2026_02.b. |
| Comment les données sont-elles organisées pour les requêter ? | La version du schéma, par exemple 0.7, et le dictionnaire correspondant. |
Plusieurs millésimes peuvent utiliser la même version du schéma. À l’inverse, une évolution de structure ne signifie pas à elle seule que les sources sont plus récentes. Un changement de millésime n’implique donc pas automatiquement un changement de schéma, et réciproquement.
La version du schéma aide à préparer une requête ou un traitement, mais ne suffit pas à garantir que les résultats seront identiques entre deux livraisons : les données peuvent avoir changé sans modification de structure.
Identifier la livraison servie par l’API
L’API BDNB sert une seule livraison à un instant donné. Celle-ci peut différer du millésime présenté dans SchemaSpy ou dans un exemple de cette page : il faut donc la vérifier avant d’interpréter un résultat obtenu par l’API.
L’encadré ci-dessous est chargé à l’ouverture de la page depuis metadonnees/info :
- le schéma de publication (
publication_schema) identifie la livraison servie ; son nom contient le millésime, par exemple202602apour2026_02.a; - la date de génération (
modifiee) indique quand cette publication API a été produite. Elle est distincte de la date d’arrêt du millésime, de la date de publication de chaque source et de la date de consultation de cette page.
Versions des sources exposées par l’API
Le tableau ci-dessous, chargé lui aussi depuis l’API de métadonnées, liste les versions des jeux de données sources de la livraison identifiée ci-dessus. La date de publication d’une source n’est pas sa date d’intégration dans la BDNB.
Chargement des métadonnées des sources…
| Jeu de données | Version / millésime | Date de publication |
|---|
Exemple d’appel API
Ces appels publics, sans clé, renvoient les métadonnées utilisées par l’encadré (metadonnees/info) et par le tableau (metadonnees/jeu_de_donnees) :
import requests
import pandas as pd
info_response = requests.get(
"https://api.bdnb.io/v1/bdnb/metadonnees/info",
timeout=30,
)
info_response.raise_for_status()
publications = pd.DataFrame(info_response.json())
print(publications[["publication_schema", "modifiee"]].drop_duplicates())
response = requests.get(
"https://api.bdnb.io/v1/bdnb/metadonnees/jeu_de_donnees",
params={
"select": "denomination_serie,millesime_jeu_de_donnees,date_publication",
"order": "denomination_serie,millesime_jeu_de_donnees",
"limit": 500,
"offset": 0,
},
timeout=30,
)
response.raise_for_status()
sources = pd.DataFrame(response.json())
print(sources.to_string(index=False))curl --fail --get 'https://api.bdnb.io/v1/bdnb/metadonnees/info'
curl --get 'https://api.bdnb.io/v1/bdnb/metadonnees/jeu_de_donnees' \
--data-urlencode 'select=denomination_serie,millesime_jeu_de_donnees,date_publication' \
--data-urlencode 'order=denomination_serie,millesime_jeu_de_donnees' \
--data-urlencode 'limit=500' \
--data-urlencode 'offset=0'Les champs utiles sont denomination_serie, millesime_jeu_de_donnees et date_publication. Le tableau pagine les résultats jusqu’à épuisement de la réponse ; pour reproduire cette lecture, augmenter offset du nombre de lignes reçues et répéter jusqu’à obtenir une réponse vide.
Quel repère conserver pour une analyse ?
Pour documenter une extraction ou un résultat, noter séparément :
- le millésime complet des données, avec sa lettre ;
- la version du schéma utilisée ;
- la date d’extraction, et pour un accès par API, le schéma de publication affiché dans l’encadré de la livraison servie.
Par exemple : « Analyse réalisée à partir de la BDNB 2026_02.b, schéma 0.7, extraite le [date de l’extraction]. »
Pour comparer deux livraisons, consulter le journal des changements et vérifier les évolutions des sources, des traitements et des prédictions. Une différence entre deux résultats ne traduit pas nécessairement une évolution réelle du parc bâti.