Power BI Desktop-projektsemantisk modellmapp
Viktigt!
Power BI Desktop-projekt är för närvarande i förhandsversion.
Den här artikeln beskriver filerna och undermapparna i ett Microsoft Power BI Desktop-projekts semantiska modellmapp . Filerna och undermapparna här representerar en Power BI-semantisk modell. Beroende på ditt projekt kan den semantiska modellmappen innehålla:
1 – Den här filen krävs.
2 – Den här filen krävs när du sparar med TMSL-format.
3 – Den här filen krävs när du sparar med TMDL-format.
Alla projektsemantiska modellmappar innehåller inte alla filer och undermappar som beskrivs här.
Semantiska modellfiler
.pbi\local Inställningar.json
Innehåller semantiska modellinställningar som endast gäller för den aktuella användaren och datorn. Det bör ingå i gitIgnore eller andra undantag för källkontroll. Som standard ignorerar Git den här filen.
Mer information finns i schemadokumentet för lokal Inställningar.json.
.pbi\editor Inställningar.json
Innehåller inställningar för semantisk modellredigerare som sparats som en del av den semantiska modelldefinitionen för användning mellan användare och miljöer.
Mer information finns i dokumentet editor Inställningar.json schema.
.pbi\cache.abf
En Analysis Services Backup-fil (ABF) som innehåller en lokal cachelagrad kopia av modellen och data när den senast redigerades. Det bör ingå i gitIgnore eller andra undantag för källkontroll. Som standard ignorerar Git den här filen.
Power BI Desktop kan öppna ett projekt utan en cache.abf-fil. I så fall öppnas rapporten som är ansluten till en modell med hela definitionen men utan data. Om det finns en cache.abf läser Power BI Desktop in data och skriver över modelldefinitionen med innehållet i model.bim.
.pbi\unappliedChanges.json
Med Power BI Desktop kan du spara ändringar som gjorts i transformeringsdataredigeraren (Power Query) utan att först tillämpa ändringarna på datamodellen.
När du väljer Tillämpa senare sparas de oanvända ändringarna i filen unappliedChanges.json. När väntande ändringar finns i filen unappliedChanges uppmanar Power BI Desktop dig att tillämpa eller ignorera de väntande ändringarna:
Om du väljer Tillämpa ändringar skriver Power BI Desktop över frågorna i model.bim med frågorna från unappliedChanges.json. Om du har redigerat frågor i model.bim utanför Power BI Desktop och det finns en tidigare unappliedChanges.json fil går dina ändringar förlorade och ersätts av frågorna i unappliedChanges.json när ändringarna tillämpas.
Den unappliedChanges.json filen införlivas automatiskt i den semantiska modelldefinitionen och sparas som standard i Git. På så sätt kan du checka in ditt pågående arbete till utvecklingsgrenen, fungera som en säkerhetskopia och göra det tillgängligt för andra teammedlemmar. Du kan dock exkludera den här filen från Gits spårning, vilket förhindrar att oavslutat frågearbete påverkar andra utvecklare.
Mer information finns i schemadokumentet för unappliedChanges.json.
definition.pbism
Innehåller den övergripande definitionen av en semantisk modell och kärninställningar.
Den här filen anger också de semantiska modelldefinitionsformat som stöds via egenskapen "version".
| Version | Format som stöds |
|---|---|
| 1.0 | Semantisk modelldefinition måste lagras som TMSL i filen model.bim. |
| 4.0 eller senare | Semantisk modelldefinition kan lagras som TMSL (model.bim-fil) eller TMDL (\definitionsmapp). |
Mer information finns i schemadokumentet definition.pbism.
model.bim
Den här filen är endast tillgänglig om Power BI-projektet sparas med TMSL-formatet. Den innehåller en TMSL-databasobjektdefinition (Tabular Model Scripting Language) för projektmodellen.
definition\ mapp
Den här filen är endast tillgänglig om Power BI-projektet sparas med TMDL-formatet. Den ersätter filen model.bim .
Den här filen innehåller en TMDL -databasobjektdefinition (Tabular Model Definition Language) för projektmodellen.
diagramLayout.json
Innehåller diagrammetadata som definierar strukturen för den semantiska modell som är associerad med rapporten. Under förhandsversionen stöder den här filen inte extern redigering.
.Plattform
Infrastrukturplattformsfil som innehåller egenskaper som är viktiga för att upprätta och underhålla anslutningen mellan Fabric-objekt och Git.
Mer information finns i Git-integrering automatiskt genererade systemfiler.
TMDL-format
Med målet att ge en bättre källkontroll och samutvecklingsupplevelse kan du spara dina Power BI Project-filer (PBIP) med hjälp av TMDL (Tabular Model Definition Language) som filformat för semantisk modell.
Till skillnad från TMSL (Tabular Model Scripting Language) har TMDL utformats från grunden för att vara människovänligt, vilket underlättar inte bara läsbarhet utan även enkel redigering i alla textredigerare. Detta representerar en betydande förbättring för källkontroll och samarbetsutvecklingsupplevelser .
I stället för en stor JSON-fil som TMSL (Tabular Model Scripting Language) har TMDL en mappstruktur med separata filer för varje tabell, perspektiv, roll och kultur. Detta gör det enklare att arbeta med andra och att förstå den semantiska modellstrukturen genom att bara titta på mappen och filerna. I slutändan leder detta till en bra källkontroll och samutvecklingsupplevelse när du hanterar git-diff-konflikter och sammanslagningskonflikter.
Läs mer om TMDL här.
Aktivera förhandsgranskningsfunktionen för TMDL-format
Spara som ett Power BI-projekt med TMDL är för närvarande i förhandsversion. Innan du använder det måste du först aktivera det i förhandsversionsfunktioner:
Gå till Filalternativ > och inställningar > Alternativ > Förhandsversionsfunktioner och markera kryssrutan bredvid Lagra semantisk modell med TMDL-format.
Spara som ett projekt med TMDL
Med funktionen TMDL Preview aktiverad sparas din semantiska modell som en TMDL-mapp med namnet \definition i mappen semantisk modell när du sparar ett projekt:
Läs mer om TMDL-mappstrukturen.
Konvertera befintlig PBIP till TMDL
Om du redan har en PBIP med TMSL som semantisk modellformat kan du konvertera den till TMDL på följande sätt:
Öppna PBIP i Power BI Desktop.
Kontrollera att förhandsgranskningsfunktionen är aktiverad.
Spara projektet. En uppmaning visas där du uppmanas att uppgradera till TMDL.
Välj Uppgradera.
Viktigt!
När du har uppgraderat till TMDL kan du inte återgå till TMSL. Om du tror att du vill återgå till TMSL sparar du först en kopia av PBIP-filerna.
Den befintliga TMSL-filen (Tabular Model Scripting Language) (model.bim) ersätts med en \definitionsmapp som innehåller TMDL-representationen av den semantiska modellen.
Om du väljer Behåll aktuellt format uppmanas inte Desktop att uppgradera igen.
Göra externa ändringar i TMDL-filer
Om du vill ha en bättre upplevelse av att läsa och redigera dina TMDL-filer installerar du tillägget TMDL – Visual Studio Marketplace Microsoft VS Code.
Öppna PBIP-mappen med HJÄLP av VS Code och gå till den semantiska modelldefinitionsmappen.
Power BI Desktop känner inte till ändringar i projektfiler som gjorts av andra verktyg. Om du gör några ändringar för att öppna filer utanför Power BI Desktop måste du därför starta om för att ändringarna ska visas i Power BI Desktop.
Se här för skrivåtgärder som stöds utanför Power BI Desktop.
TMDL-fel
Om ogiltiga ändringar görs i TMDL-filerna genererar Power BI Desktop ett fel vid öppning, med platsen för felet:
Fabric Git-integrering med TMDL
Under den offentliga förhandsversionen exporterar Fabric Git-integreringen fortfarande den semantiska modellen med TMSL som standard. Men om den semantiska modellen importeras till Infrastruktur med hjälp av Fabric Git-integrering med TMDL-format använder Fabric Git-integrering TMDL-format för att exportera semantisk modelldefinition till Git om det finns några semantiska modelländringar i tjänsten.
Viktigt!
Om du importerar din semantiska modell med någon annan importmetod, till exempel Power BI Desktop Publish, växlar Fabric Git-integreringen tillbaka till standard-TMSL-formatet.
Relaterat innehåll
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för