Dossier du modèle sémantique de projet Power BI Desktop
Important
Les projets Power BI Desktop sont actuellement en préversion.
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 :
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. S’il existe un fichier cache.abf, Power BI Desktop charge les données et remplace la définition du modèle par le contenu dans model.bim.
.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 les modifications, Power BI Desktop remplace les requêtes dans model.bim par les requêtes du fichier unappliedChanges.json. Si vous avez modifié des requêtes dans le fichier model.bim en dehors de Power BI Desktop et qu’il existe un fichier unappliedChanges.json antérieur, vos modifications sont perdues et remplacées par les requêtes contenues dans unappliedChanges.json au moment où 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.pbidataset.
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 (Tabulaire 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. Pendant la PRÉVERSION, ce fichier ne prend pas en charge la modification externe.
Mail Luck!.
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èmes de l’intégration Git générés automatiquement.
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 grande expérience de contrôle de code source et de co-développement lors de la gestion des différences Git et de fusionner les conflits.
En savoir plus sur le TMDL ici.
Activer la fonctionnalité d’évaluation du format TMDL
L’enregistrement comme projet Power BI à l’aide de TMDL est actuellement en préversion. Avant de l’utiliser, vous devez d’abord l’activer dans les fonctionnalités d’évaluation :
Accédez à Fichier > Options et paramètres > Options > Fonctionnalités en préversion, et cochez la case en regard de Enregistrer le modèle sémantique au format TMDL.
Enregistrer en tant que projet au format TMDL
Une fois la fonctionnalité d’évaluation TMDL activée, lorsque vous enregistrez un projet, votre modèle sémantique est enregistré sous la forme d’un dossier TMDL nommé \definition dans un dossier du modèle sémantique :
En savoir plus sur la structure du dossier TMDL.
Convertir un fichier PBIP existant en TMDL
Si vous disposez déjà d’un fichier PBIP avec TMSL comme format de modèle sémantique, vous pouvez le convertir en TMDL comme suit :
Ouvrez le fichier PBIP dans Power BI Desktop.
Assurez-vous de l’activation de la fonctionnalité d’évaluation.
Enregistrez le projet. Une invite vous demandant de procéder à une mise à niveau vers TMDL s’affiche.
Sélectionnez Mettre à niveau.
Important
Une fois la mise à niveau vers TMDL effectuée, vous ne pouvez pas revenir à TMSL. Si vous envisagez un possible retour à TMSL, enregistrez une copie de vos fichiers PBIP au préalable.
Le fichier TMSL (Tabular Model Scripting Language) existant (model.bim) est remplacé par un dossier \definition contenant la représentation TMDL du modèle sémantique.
Si vous sélectionnez Conserver le format actuel, l’appareil de bureau ne va plus vous inviter à effectuer la mise à niveau.
Apporter des modifications externes aux fichiers TMDL
Pour une meilleure expérience de lecture et de modification de vos fichiers TMDL, installez l’extension Microsoft VS Code TMDL – Visual Studio Marketplace.
Ouvrez le dossier PBIP à l’aide de VS Code et naviguez vers le dossier de définition de modèle sémantique.
Power BI Desktop ne peut pas identifier les modifications apportées aux fichiers de projet par d’autres outils. Par conséquent, si vous apportez des modifications afin d’ouvrir des fichiers en dehors de Power BI Desktop, vous devez redémarrer pour afficher ces modifications dans Power BI Desktop.
Voir ici pour connaître les opérations d’écriture prises en charge en dehors de Power BI Desktop.
Erreurs TMDL
Si des modifications non valides sont apportées aux fichiers TMDL, Power BI Desktop renvoie une erreur sur le fichier ouvert, avec l’emplacement de l’erreur :
Considérations et limites des TMDL
Pendant la préversion publique, l’intégration Git Fabric exporte toujours le modèle sémantique à l’aide de TMSL par défaut. Si le modèle sémantique est toutefois importé dans Fabric en utilisant l’intégration Fabric Git avec le format TMDL, l’intégration Fabric Git utilise le format TMDL pour exporter la définition du modèle sémantique vers Git s’il existe des modifications du modèle sémantique dans le service.
Important
Si vous importez votre modèle sémantique en utilisant toute autre méthode d’importation, par exemple, Power BI Desktop Publish, l’intégration Fabric Git revient au format TMSL par défaut.