Semantische modelmap van Power BI Desktop-project
Belangrijk
Power BI Desktop-projecten zijn momenteel beschikbaar als preview-versie.
In dit artikel worden de bestanden en submappen in de Semantische modelmap van een Microsoft Power BI Desktop-project beschreven. De bestanden en submappen hier vertegenwoordigen een semantisch Power BI-model. Afhankelijk van uw project kan de semantische modelmap het volgende omvatten:
1 - Dit bestand is vereist.
2 - Dit bestand is vereist bij het opslaan met de TMSL-indeling.
3 - Dit bestand is vereist bij het opslaan met de TMDL-indeling.
Niet elke semantische projectmodelmap bevat alle bestanden en submappen die hier worden beschreven.
Semantische modelbestanden
.pbi\localSettings.json
Bevat semantische modelinstellingen die alleen van toepassing zijn op de huidige gebruiker en computer. Deze moet worden opgenomen in gitIgnore of andere uitsluitingen voor broncodebeheer. Standaard negeert Git dit bestand.
Zie het localSettings.json schemadocument voor meer informatie.
.pbi\editorSettings.json
Bevat semantische editorinstellingen voor modellen die zijn opgeslagen als onderdeel van de semantische modeldefinitie voor gebruik in gebruikers en omgevingen.
Zie het editorSettings.json schemadocument voor meer informatie.
.pbi\cache.abf
Een ABF-bestand (Analysis Services Backup) met een lokale kopie van het model en de gegevens in de cache toen het voor het laatst werd bewerkt. Deze moet worden opgenomen in gitIgnore of andere uitsluitingen voor broncodebeheer. Standaard negeert Git dit bestand.
Power BI Desktop kan een project openen zonder een cache.abf-bestand. In dat geval wordt het rapport geopend dat is verbonden met een model met de volledige definitie, maar zonder gegevens. Als er een cache.abf bestaat, worden de gegevens in Power BI Desktop geladen en wordt de modeldefinitie overschreven met de inhoud in model.bim.
.pbi\unappliedChanges.json
Met Power BI Desktop kunt u wijzigingen opslaan die zijn aangebracht in de transformatiegegevenseditor (Power Query) zonder deze wijzigingen eerst toe te passen op het gegevensmodel.
Wanneer u Later toepassen selecteert, worden de niet-toegepaste wijzigingen opgeslagen in het unappliedChanges.json-bestand. Wanneer wijzigingen in behandeling zijn in het bestand unappliedChanges, wordt u door Power BI Desktop gevraagd deze wijzigingen in behandeling toe te passen of te negeren:
Als u Wijzigingen toepassen selecteert, overschrijft Power BI Desktop de query's in model.bim met de query's uit unappliedChanges.json. Als u query's in model.bim buiten Power BI Desktop hebt bewerkt en er een eerder unappliedChanges.json bestand is, gaan uw wijzigingen verloren en vervangen door de query's in unappliedChanges.json wanneer deze wijzigingen worden toegepast.
Het unappliedChanges.json-bestand wordt automatisch opgenomen in de definitie van het semantische model en standaard opgeslagen in Git. Hiermee kunt u uw doorlopende werkzaamheden doorvoeren in de ontwikkelingsbranch, die als back-up fungeert en toegankelijk maken voor andere teamleden. U kunt dit bestand echter uitsluiten van het bijhouden van Git, waardoor het niet-voltooide querywerk niet van invloed is op andere ontwikkelaars.
Zie het unappliedChanges.json schemadocument voor meer informatie.
definition.pbism
Bevat de algemene definitie van een semantisch model en kerninstellingen.
Dit bestand geeft ook de ondersteunde semantische modeldefinitieindelingen op via de eigenschap 'version'.
| Versie | Ondersteunde indelingen |
|---|---|
| 1.0 | Semantische modeldefinitie moet worden opgeslagen als TMSL in het bestand model.bim. |
| 4.0 of hoger | Semantische modeldefinitie kan worden opgeslagen als TMSL (model.bim-bestand) of TMDL (\definition folder). |
Zie het schemadocument definition.pbism voor meer informatie.
model.bim
Dit bestand is alleen beschikbaar als het Power BI-project wordt opgeslagen met de TMSL-indeling. Het bevat een TMSL-databaseobjectdefinitie (Tabular Model Scripting Language) van het projectmodel.
definitie\ map
Deze map is alleen beschikbaar als het Power BI-project wordt opgeslagen met de TMDL-indeling. Het bestand model.bim wordt vervangen.
Deze map bevat een TMDL-databaseobjectdefinitie (Tabular Model Definition Language) van het projectmodel.
diagramLayout.json
Bevat diagrammetagegevens die de structuur van het semantische model definiëren dat aan het rapport is gekoppeld. Tijdens PREVIEW biedt dit bestand geen ondersteuning voor extern bewerken.
platform.
Fabric-platformbestand met eigenschappen die essentieel zijn voor het tot stand brengen en onderhouden van de verbinding tussen Fabric-items en Git.
Zie git-integratie automatisch gegenereerde systeembestanden voor meer informatie.
TMDL-indeling
U kunt uw Power BI Project-bestanden (PBIP) opslaan met behulp van TMDL (Tabular Model Definition Language) als de semantische modelbestandsindeling.
In tegenstelling tot Tabular Model Scripting Language (TMSL) is TMDL vanaf het begin ontworpen om mensvriendelijk te zijn, waardoor niet alleen leesbaarheid , maar ook eenvoudig kan worden bewerkt in een teksteditor. Dit is een aanzienlijke verbetering voor broncodebeheer en samenwerkingsontwikkelingservaringen .
In plaats van een groot JSON-bestand, zoals Tabular Model Scripting Language (TMSL), heeft TMDL een mapstructuur met afzonderlijke bestanden voor elke tabel, perspectief, rol en cultuur. Dit maakt het gemakkelijker om met anderen te werken en de semantische modelstructuur te begrijpen door alleen de map en bestanden te bekijken. Uiteindelijk leidt dit tot een geweldige ervaring voor broncodebeheer en co-ontwikkeling bij het omgaan met git-diff's en samenvoegingsconflicten.
Meer informatie over TMDL vindt u hier.
Preview-functie voor TMDL-indeling inschakelen
Opslaan als een Power BI-project met TMDL is momenteel beschikbaar als preview-versie. Voordat u deze gebruikt, moet u deze eerst inschakelen in preview-functies:
Ga naar > functies voor opties voor bestandsopties en instellingen >> en schakel het selectievakje naast store-semantisch model in met de TMDL-indeling.
Opslaan als een project met TMDL
Als de functie TMDL Preview is ingeschakeld, wordt uw semantische model opgeslagen als een TMDL-map met de naam \definition in de semantische modelmap:
Meer informatie over de TMDL-mapstructuur.
Bestaande PBIP converteren naar TMDL
Als u al een PBIP hebt met TMSL als semantische modelindeling, kunt u deze als volgt converteren naar TMDL:
Open het PBIP in Power BI Desktop.
Zorg ervoor dat de preview-functie is ingeschakeld.
Sla het project op . Er verschijnt een prompt waarin u wordt gevraagd om een upgrade uit te voeren naar TMDL.
Selecteer Upgraden.
Belangrijk
Nadat u een upgrade naar TMDL hebt uitgevoerd, kunt u niet teruggaan naar TMSL. Als u denkt dat u misschien wilt terugkeren naar TMSL, slaat u eerst een kopie van uw PBIP-bestanden op.
Het bestaande TMSL-bestand (Tabular Model Scripting Language) wordt vervangen door een \definition-map met de TMDL-weergave van het semantische model.
Als u ervoor kiest om de huidige indeling te behouden, wordt desktop niet opnieuw gevraagd om een upgrade uit te voeren.
Externe wijzigingen aanbrengen in TMDL-bestanden
Voor een betere ervaring met het lezen en bewerken van uw TMDL-bestanden installeert u de TMDL - Visual Studio Marketplace Microsoft VS Code-extensie.
Open de PBIP-map met behulp van VS Code en navigeer naar de semantische modeldefinitiemap.
Power BI Desktop is niet op de hoogte van wijzigingen in projectbestanden die door andere hulpprogramma's zijn aangebracht. Als u daarom wijzigingen aanbrengt om bestanden buiten Power BI Desktop te openen, moet u deze wijzigingen opnieuw starten om deze wijzigingen weer te geven in Power BI Desktop.
Raadpleeg hier voor ondersteunde schrijfbewerkingen buiten Power BI Desktop.
TMDL-fouten
Als er ongeldige wijzigingen worden aangebracht in de TMDL-bestanden, genereert Power BI Desktop een fout bij openen, met de locatie van de fout:
TMDL-overwegingen en -beperkingen
Tijdens de openbare preview exporteert Git-integratie van Fabric het semantische model standaard nog steeds met behulp van TMSL. Als het semantische model echter wordt geïmporteerd in Fabric met behulp van Fabric Git Integration met TMDL-indeling, gebruikt Fabric Git Integration de TMDL-indeling om de semantische modeldefinitie naar Git te exporteren als er semantische modelwijzigingen in de service zijn.
Belangrijk
Als u uw semantische model importeert met een andere importmethode, zoals Power BI Desktop Publish, schakelt Git Integration van infrastructuur terug naar de standaard TMSL-indeling.
Gerelateerde inhoud
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor