Guide complet (PDF)

Formats de données proposés

N° 12

Format SQL de DV3F

Export PDF

🗄Version SQL de DV3F

Depuis sa première version, la base DV3F est proposée au format SQL pour PostgreSQL/PostGIS, afin de permettre une restauration directe en base de données.

⚠️ Ce format restitue l’ensemble de la structure relationnelle DV3F (tables, clés, relations, index), avec une restauration par département. Depuis la version 2025-1, il n'y a plus recours à l’héritage dans le modèle (fonctionnalité peu maintenue sous PostgreSQL, compatibilité limitée).

🧰 Type d'utilisation

Ce format est particulièrement adapté à des usages avancés et structurés :

  • Intégration dans une base relationnelle PostgreSQL/PostGIS
  • Requêtes SQL complexes sur les transactions et leurs relations (locaux, parcelles,acheteurs/vendeurs, etc.)
  • Analyses croisées exploitant l’ensemble du modèle DV3F et d'autres sources
  • Intégration dans des chaînes de traitement ou plateformes de données

✅ Avantages

  • Structure relationnelle complète : toutes les tables DV3F sont disponibles
  • Cohérence garantie : intégrité du modèle grâce aux clés et contraintes définies dans dv3f_init.sql
  • Performant : possibilité d’interroger de gros volumes de données via SQL

❌ Limites

  • Installation nécessaire : requiert un serveur PostgreSQL (local ou distant) pour l’intégration
  • Volume important : les fichiers départementaux peuvent être lourds à charger
  • Utilisateur averti : des compétences minimales en SQL sont nécessaires pour interroger la donnée

📥 Comment récupérer les données ?

  • 🧭 Nouveau sur le portail ? Suivez le parcours guidé pour créer un compte "bénéficiaire"
  • 👤 Déjà inscrit ? Connectez-vous à votre espace
  • 📄 Faites une demande de téléchargement
  • Cliquez sur le bouton "Télécharger une donnée"
  • 📝 Remplissez le formulaire
  • Indiquez la donnée souhaitée DV3F
  • Précisez le format SQL et le périmètre géographique
  • Une invitation Box.com vous parviendra sous 24 à 48h
  • 📦 Téléchargez l'archive
  • Connectez-vous à l’espace sécurisé pour récupérer le fichier compressé (.7z)

📁 Description des fichiers obtenus

Selon le volume de données demandé, vous recevrez plusieurs fichiers découpés (taille < 800 Mo) : DV3F_AAAA_V_SQL_NNNN_EDAA1_part.7z.001, .002, etc.

🛠️ Comment utiliser les données ?

🗂 Étape 1 – Décompresser l’archive

Utilisez un outil de décompression adapté extraire les données .7zà partir d'outils libres comme 7-Zip ou PeaZip → voir tutoriel 7-zip

⚠️ Pour les fichiers découpés (.7z.001), commencez toujours la décompression à partir du fichier numéro 1 en s'assurant que tous les fichiers numérotés sont présents dans le même dossier.

Une fois l’archive décompressée (voir Etape 1 ci-après), vous obtenez trois dossiers :

🔹 1_DONNEES_LIVRAISON → contient les fichiers de données sql

🔹 4_METADONNEES_LIVRAISON → contient le fichier de métadonnées et les documents juridiques (acte d'engagement, CGU)

🔹 5_SUPPLEMENTS_LIVRAISON → généralement vide (réservé à des compléments éventuels)

📑 Étape 2 – Restaurer les fichiers SQL sous PostgreSQL

L’archive contient :

  • dv3f_init.sql → script d’initialisation (création du schéma et des tables, contraintes, index, etc.)
  • dv3f_dXX.sql → un fichier par département (XX = code département), contenant les requêtes d'insertions des données
  • dv3f_annexe.sql → script de restauration des tables annexes DV3F (dictionnaires, nomenclatures, typologies, etc.)

⚠️ Pour restaurer les fichiers SQL, il faut préalablement avoir accès à une instance PostgreSQL avec l'extension PostGIS.

  1. Créez une base vide dans votre instance PostgreSQL si nécessaire:
CREATE DATABASE dv3f_db;
  1. Activez l'extension Postgis dans votre base de donnée :
psql -d dv3f_db -c "CREATE EXTENSION postgis;"
  1. Exécutez le script d’initialisation :
psql -d dv3f_db -f dv3f_init.sql
  1. Chargez les données départementales (répétez pour chaque fichier dv3f_dXX.sql) :
psql -d dv3f_db -f dv3f_d75.sql
psql -d dv3f_db -f dv3f_d13.sql
...
  1. Chargez les tables annexes :
psql -d dv3f_db -f dv3f_annexe.sql

Définition du SRID des colonnes géométriques

A partir du millésime 2026-1 de DV3F, les tables auparavant départementales ont été agrégées à l’échelle nationale.

Cette agrégation couvre la France hexagonale ainsi que les départements d’outre-mer.

En conséquence, les colonnes géométriques ne sont plus typées.

Vous trouverez ci-dessous une série de requêtes permettant de rétablir le typage des géométries.

L’exemple est donné pour la France hexagonale avec le SRID 2154 ; celui-ci devra être adapté dans le cas d’un département d’outre-mer.

Table mutation

ALTER TABLE dv3f_2026_1.mutation ALTER COLUMN geompar TYPE geometry(MultiPolygon, 2154) USING ST_SetSRID(ST_Multi(geompar), 2154);
ALTER TABLE dv3f_2026_1.mutation ALTER COLUMN geomparmut TYPE geometry(MultiPolygon, 2154) USING ST_SetSRID(ST_Multi(geomparmut), 2154);
ALTER TABLE dv3f_2026_1.mutation ALTER COLUMN geomlocmut TYPE geometry(MultiPoint, 2154) USING ST_SetSRID(ST_Multi(geomlocmut), 2154);

Table disposition_parcelle

ALTER TABLE dv3f_2026_1.disposition_parcelle ALTER COLUMN geompar TYPE geometry(MultiPolygon, 2154) USING ST_SetSRID(ST_Multi(geompar), 2154);
ALTER TABLE dv3f_2026_1.disposition_parcelle ALTER COLUMN geomloc TYPE geometry(MultiPoint, 2154) USING ST_SetSRID(ST_Multi(geomloc), 2154);

Table local

ALTER TABLE dv3f_2026_1.local ALTER COLUMN geomloc TYPE geometry(MultiPoint, 2154) USING ST_SetSRID(ST_Multi(geomloc), 2154);

🗂 Étape 3 – Interroger les données

Vous pouvez ensuite exécuter vos requêtes SQL, par exemple :

-- Nombre de mutations par année
SELECT anneemut, COUNT(*) 
FROM dv3f_2025_1.mutation
GROUP BY anneemut
ORDER BY anneemut;

ℹ️ Besoin d’aide ?

Pour toute difficulté, vous pouvez contacter l’équipe Datafoncier