Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article décrit les fichiers et sous-dossiers dans le dossier Modèle sémantique d’un projet Microsoft Power BI Desktop. Les fichiers et sous-dossiers représentent ici un modèle sémantique Power BI. Selon votre projet, le dossier du modèle sémantique peut contenir :
- .pbi\
- Dossier DAXQueries\
- Dossier TMDLScripts/
- Dossier définition3
- model.bim2
- diagramLayout.json
- .plateforme
- definition.pbism1
1 – Ce fichier est nécessaire.
2 – Ce fichier est obligatoire lors de l’enregistrement au format TMSL.
3 – Ce fichier est obligatoire lors de l’enregistrement au format TMSL.
Tous les dossiers du modèle sémantique de projet ne comprennent pas tous les fichiers et sous-dossiers décrits ici.
Fichiers du modèle sémantique
.pbi\localSettings.json
Contient des paramètres du modèle sémantique qui s’appliquent uniquement à l’utilisateur et à l’ordinateur actuels. Il doit être inclus dans gitIgnore ou d’autres exclusions de contrôle de code source. Par défaut, Git ignore ce fichier.
Pour plus d’informations, consultez le document de schéma localSettings.json.
.pbi\editorSettings.json
Contient les paramètres de l’éditeur de modèles sémantiques enregistrés dans le cadre de la définition du modèle sémantique pour une utilisation entre les utilisateurs et les environnements.
Pour plus d’informations, consultez le document de schéma editorSettings.json.
.pbi\cache.abf
Un fichier de sauvegarde Analysis Services (ABF) contenant une copie mise en cache locale du modèle et des données lors de sa dernière modification. Il doit être inclus dans gitIgnore ou d’autres exclusions de contrôle de code source. Par défaut, Git ignore ce fichier.
Power BI Desktop peut ouvrir un projet sans fichier cache.abf. Dans ce cas, il ouvre le rapport connecté à un modèle avec sa définition entière, mais sans données. Si un cache.abf existe, Power BI Desktop charge les données et remplace la définition du modèle avec les métadonnées du modèle sémantique dans le projet.
.pbi\unappliedChanges.json
Power BI Desktop vous permet d’enregistrer les modifications apportées à l’éditeur de données de transformation (Power Query) sans appliquer ces modifications au modèle de données.
Lorsque vous sélectionnez Appliquer plus tard, les modifications non appliquées sont enregistrées dans le fichier unappliedChanges.json. Lorsque des modifications en attente se trouvent dans le fichier unappliedChanges, Power BI Desktop vous invite à appliquer ou à ignorer ces modifications en attente :
Si vous sélectionnez Appliquer des modifications, Power BI Desktop remplace les requêtes dans les métadonnées du modèle sémantique avec les requêtes de unappliedChanges.json. Si vous avez modifié des requêtes en dehors de Power BI Desktop et qu’il existe un fichier unappliedChanges.json précédent, vos modifications sont perdues et remplacées par les requêtes dans unappliedChanges.json lorsque ces modifications sont appliquées.
Le fichier unappliedChanges.json est automatiquement incorporé dans la définition du modèle sémantique et enregistré dans Git par défaut. Cela vous permet de valider votre travail en cours dans la branche de développement. Elle fait alors office de sauvegarde et devient accessible aux autres membres de l’équipe. Cependant, vous pouvez exclure ce fichier du suivi de Git, ce qui évite aux autres développeurs d’être affectés par un travail de requête inachevé.
Pour plus d’informations, consultez le document de schéma unappliedChanges.json.
definition.pbism
Contient la définition globale d’un modèle sémantique et des paramètres principaux.
Ce fichier spécifie également les formats de définition de modèle sémantique pris en charge par le biais de la propriété « version ».
| Version | Formats pris en charge |
|---|---|
| 1,0 | La définition de modèle sémantique doit être stockée au format TMSL dans le fichier model.bim. |
| 4.0 ou version ultérieure | La définition de modèle sémantique peut être stockée au format TMSL (fichier model.bim) ou TMDL (dossier \definition). |
Pour plus d’informations, consultez le document de schéma de definition.pbism.
model.bim
Ce fichier n’est disponible que si le projet Power BI est enregistré au format TMSL. Il contient une définition de l’objet de base de données TMSL (Tabular Model Scripting Language) du modèle de projet.
Dossier definition\
Ce dossier n’est disponible que si le projet Power BI est enregistré au format TMDL. Il remplace le fichier model.bim.
Ce dossier contient une définition d’objet de base de données TMDL (Tabular Model Definition Language)du modèle de projet.
diagramLayout.json
Il contient des métadonnées de diagramme définissant la structure du modèle sémantique associé au rapport. Vous ne pouvez pas modifier ce fichier en externe.
.platform
Le fichier de plateforme Fabric qui contient les propriétés vitales pour établir et maintenir la connexion entre des éléments Fabric et Git.
Pour plus d’informations, consultez Fichiers système générés automatiquement par l’intégration Git.
Dossier DAXQueries\
Contient un fichier pour chaque onglet de vue de requête DAX enregistré sous forme de [Tab name].dax fichier DAX.
.pbi\daxQueries.json
Contient les paramètres de l’éditeur de vue de requête DAX, tels que defaultTab ou l’ordre de tabulation.
Dossier TMDLScripts\
Contient un fichier pour chaque onglet de script de vue TMDL, enregistré sous la forme d'un fichier TMDL [Tab name].tmdl.
.pbi\tmdlscripts.json
Contient les paramètres de l’éditeur de vue TMDL , tels que defaultTab ou l’ordre de tabulation.
Format TMDL
L’objectif étant de fournir une meilleure expérience de contrôle de code source et de co-développement, vous pouvez enregistrer vos fichiers de projet Power BI (PBIP) au langage TMDL (Tabular Model Definition Language) comme format de fichier du modèle sémantique.
Contrairement au langage TMSL (Tabular Model Scripting Language), TMDL a été entièrement conçu pour être convivial, ce qui facilite non seulement la lisibilité, mais aussi la modification dans n’importe quel éditeur de texte. Il s’agit d’une substantielle amélioration du contrôle de code source et des expériences de développement collaboratif.
Plutôt qu’un grand fichier JSON comme TMSL (Tabular Model Scripting Language), TMDL a une structure de dossiers avec des fichiers distincts pour chaque table, perspective, rôle et culture. Cela facilite la collaboration avec d’autres personnes et la compréhension de la structure du modèle sémantique, en examinant simplement le dossier et les fichiers. En fin de compte, cela conduit à une excellente expérience de contrôle de code source et de co-développement lors de la gestion des différences et des conflits de fusion avec Git.
En savoir plus sur le TMDL ici.
Apporter des modifications externes aux fichiers TMDL
Vous pouvez modifier des fichiers TMDL dans Visual Studio Code ou un autre outil externe pendant que le projet reste ouvert dans Power BI Desktop. Pour une meilleure expérience d’édition TMDL, installez l’extension TMDL pour Visual Studio Code.
Avant de modifier les fichiers en externe, enregistrez les modifications apportées à Power BI Desktop. Ouvrez le dossier PBIP dans VS Code, accédez au dossier de modèle definition sémantique et enregistrez vos modifications TMDL. Power BI Desktop détecte les modifications enregistrées et affiche la bannière Appliquer les modifications externes. Sélectionnez Appliquer des modifications externes pour recharger le modèle sémantique sans fermer et rouvrir le projet.
Si Power BI Desktop a des modifications non enregistrées, il vous avertit que l’application des modifications externes les remplacera. Pour connaître les limitations et le flux de travail complets, consultez Modifier les fichiers PBIP en dehors de Power BI Desktop.
Pour connaître les opérations d’écriture prises en charge en dehors de Power BI Desktop, consultez Création de modèles.
Erreurs de TMDL
Si une modification TMDL n’est pas valide, Power BI Desktop affiche une erreur lorsque vous appliquez les modifications externes ou ouvrez le projet. L’erreur identifie l’emplacement que vous devez corriger avant que Power BI Desktop puisse charger le modèle sémantique mis à jour :
