Les formats de fichiers : PBIX, PBIT, PBIP, PBIR, TMDL
En bref
- Objectifs : distinguer les formats PBIX, PBIT et PBIP ; expliquer le rôle des formats texte PBIR (rapport) et TMDL (modèle) ; choisir le format adapté à votre usage ; convertir un fichier d'un format à l'autre.
- Prérequis : page « Découvrir l'interface de Power BI Desktop et du service ».
- Niveau : découverte (PBIX, PBIT), intermédiaire (PBIP).
Pourquoi ?
Pendant longtemps, un rapport Power BI tenait dans un seul fichier PBIX, pratique mais opaque : impossible de voir ce qui a changé entre deux versions ou de travailler à plusieurs sur le même rapport. Les formats texte (PBIP, PBIR, TMDL) répondent à ce besoin de suivi des versions et de collaboration. Le modèle PBIT, lui, sert à réutiliser un rapport type avec d'autres données.
Notions clés
Vue d'ensemble
| Format | Nature | Contenu | Usage type |
| PBIX | Fichier unique (archive) | Rapport, modèle sémantique, requêtes et données importées | Format par défaut, échange simple, publication depuis Desktop |
| PBIT | Fichier unique (modèle de rapport) | Pages, visuels, modèle, requêtes et paramètres, sans données | Rapport type à réutiliser avec d'autres sources ou paramètres |
| PBIP | Dossier de fichiers texte | Rapport (dossier .Report) et modèle (dossier .SemanticModel) | Suivi des versions avec Git, travail en équipe, CI/CD |
| PBIR | Format texte du rapport | Un fichier JSON par page, visuel et signet | Contenu du dossier .Report ; aussi utilisé à l'intérieur des PBIX |
| TMDL | Format texte du modèle | Un fichier par table, rôle, culture, perspective | Contenu du dossier .SemanticModeldefinition ; vue TMDL de Desktop |
PBIX : le format historique
Le PBIX contient tout : le rapport, le modèle, les requêtes Power Query et les données importées. C'est le format proposé par défaut à l'enregistrement et celui que l'on télécharge depuis le service. Il reste le format principal pour la plupart des utilisateurs. Son défaut : c'est un fichier binaire, que Git ne sait pas comparer ni fusionner.
PBIT : le modèle de rapport
Un PBIT contient les pages, les visuels, la définition du modèle (schéma, relations, mesures) et les requêtes avec leurs paramètres, mais aucune donnée. À l'ouverture, Power BI Desktop demande les valeurs des paramètres et l'emplacement des données, puis crée un nouveau rapport. Source
PBIP : le projet Power BI
Un projet Power BI enregistre le rapport et le modèle sous forme de fichiers texte lisibles dans un dossier :
Ventes/
├── Ventes.Report/ # définition du rapport (PBIR)
├── Ventes.SemanticModel/ # définition du modèle (dossier definition en TMDL)
├── .gitignore
└── Ventes.pbipVentes.pbipest un raccourci qui ouvre le rapport dans Power BI Desktop..gitignoreest créé automatiquement s'il n'existe pas. Il exclut.pbi/localSettings.json(réglages propres au poste) et.pbi/cache.abf(les données importées, qui ne doivent pas aller dans Git pour des raisons de taille et de confidentialité). Sans ce cache, Desktop ouvre le modèle sans données ; il suffit d'actualiser.definition.pbism(modèle) etdefinition.pbir(rapport) indiquent la version de format utilisée.
PBIR : le rapport en fichiers texte
Le format PBIR remplace l'ancien fichier unique report.json (appelé désormais PBIR-Legacy) par un dossier definition contenant un fichier par page, par visuel et par signet. Il est documenté publiquement (schémas JSON), ce qui autorise les modifications par d'autres outils, et il facilite la lecture des différences et la fusion. Source
PBIR est devenu le format par défaut des nouveaux rapports dans le service Power BI à partir de 2026, puis dans Power BI Desktop, y compris à l'intérieur des fichiers PBIX : le changement est transparent pour l'utilisateur d'un PBIX. Les rapports encore en PBIR-Legacy sont convertis lorsqu'ils sont modifiés. Source (blog Power BI)
TMDL : le modèle en fichiers texte
TMDL (Tabular Model Definition Language) décrit le modèle sémantique dans un dossier definition avec un fichier par table, rôle, culture et perspective. Il remplace l'ancien fichier JSON unique model.bim (format TMSL). Les mesures, colonnes et relations y sont lisibles et comparables ligne à ligne. La même syntaxe est utilisée dans la vue TMDL de Power BI Desktop, disponible en version finale, pour scripter et modifier des objets du modèle. Source
Le passage d'un projet en TMDL est irréversible : sauvegardez le dossier avant la conversion.
Statut en 2026
Microsoft a annoncé en septembre 2026 la disponibilité générale du mode développeur (PBIP avec PBIR et TMDL). Selon votre version de Power BI Desktop et la date de mise à jour de la documentation, ces options peuvent encore figurer dans Fichier > Options et paramètres > Options > Fonctionnalités en préversion.
Pas à pas
Enregistrer un rapport en projet PBIP
1. Ouvrez le fichier PBIX dans Power BI Desktop.
2. Si nécessaire, activez dans Options > Fonctionnalités en préversion l'enregistrement en projet Power BI, le stockage du rapport en PBIR et du modèle en TMDL.
3. Fichier > Enregistrer sous > type Projet Power BI (*.pbip).
[Capture : boîte de dialogue Enregistrer sous de Power BI Desktop, type « Projet Power BI (*.pbip) » sélectionné]
4. Choisissez un dossier dédié, au chemin court (la longueur des chemins Windows est limitée à 260 caractères par défaut).
5. Ouvrez le dossier dans l'Explorateur Windows et repérez les dossiers .Report et .SemanticModel.
[Capture : Explorateur Windows montrant les dossiers Ventes.Report, Ventes.SemanticModel, le fichier .gitignore et Ventes.pbip]
Revenir à un PBIX ou créer un PBIT
- PBIP vers PBIX : ouvrez le
.pbip, puis Fichier > Enregistrer sous > type Fichier Power BI (*.pbix). La conversion ne se fait que par cette commande, dans les deux sens. - Créer un PBIT : Fichier > Exporter > Modèle Power BI, saisissez une description, puis enregistrez.
[Capture : menu Fichier > Exporter de Power BI Desktop avec l'option Modèle Power BI]
Exemple
Après l'ajout d'une mesure dans un projet PBIP, seul le fichier definition/tables/Ventes.tmdl est modifié. Ce fichier, que l'on peut comparer à sa version précédente dans Visual Studio Code, contient alors des lignes de ce type :
measure 'Marge %' = DIVIDE([Marge], [Chiffre d'affaires])
formatString: 0.0%La démarche complète de suivi des versions (Git, Visual Studio Code, intégration Git d'un espace de travail) est décrite dans la page « Suivi des versions avec Git : méthode industrielle » (Annexes).
Pièges et bonnes pratiques
- Power BI Desktop ne détecte pas les modifications faites par un autre outil pendant qu'il est ouvert : fermez-le avant de modifier les fichiers, puis rouvrez le projet.
- L'enregistrement direct d'un projet PBIP dans OneDrive ou SharePoint n'est pas pris en charge : utilisez un dossier local versionné avec Git.
- Les fichiers sont en UTF-8 sans BOM ; ne les réenregistrez pas avec un éditeur qui change l'encodage.
- Un PBIT ne contient pas de données, mais ses métadonnées peuvent conserver des valeurs (filtres, sélections de segments) : relisez-le avant de le diffuser.
À retenir
- PBIX reste le format courant ; il contient les données.
- PBIT est un rapport type sans données, qui demande ses paramètres à l'ouverture.
- PBIP éclate le rapport (PBIR) et le modèle (TMDL) en fichiers texte, pour Git et le travail en équipe.
- Les données (
cache.abf) ne vont jamais dans le dépôt Git.