Mappe med semantisk model til Power BI Desktop-projekt

I denne artikel beskrives filerne og undermapperne i mappen Semantisk model i et Microsoft Power BI Desktop-projekt. Filerne og undermapperne her repræsenterer en semantisk Power BI-model. Afhængigt af dit projekt kan mappen med semantiske modeller indeholde:

1 – Denne fil er påkrævet.
2 – Denne fil er påkrævet, når du gemmer i TMSL-format.
3 – Denne fil er påkrævet, når der gemmes i TMDL-format.

Ikke alle semantiske projektmodelmapper indeholder alle de filer og undermapper, der er beskrevet her.

Semantiske modelfiler

.pbi\localSettings.jspå

Indeholder semantiske modelindstillinger, der kun gælder for den aktuelle bruger og computer. Den skal inkluderes i gitIgnore eller andre udeladelser af kildekontrol. Som standard ignorerer Git denne fil.

Du kan få flere oplysninger i skemadokumentet localSettings.json.

.pbi\editorSettings.jspå

Indeholder indstillinger for semantisk modeleditor, der er gemt som en del af den semantiske modeldefinition til brug på tværs af brugere og miljøer.

Du kan få flere oplysninger i skemadokumentet editorSettings.json.

.pbi\cache.abf

En ABF-fil (Analysis Services Backup), der indeholder en lokal cachelagret kopi af modellen og dataene, da den sidst blev redigeret. Den skal inkluderes i gitIgnore eller andre udeladelser af kildekontrol. Som standard ignorerer Git denne fil.

Power BI Desktop kan åbne et projekt uden en cache.abf-fil. I så fald åbnes den rapport, der er forbundet med en model, med hele definitionen, men uden data. Hvis der findes en cache.abf, indlæser Power BI Desktop dataene og overskriver modeldefinitionen med de semantiske modelmetadata i projektet.

.pbi\unappliedChanges.jspå

Med Power BI Desktop kan du gemme ændringer, der er foretaget i Transformér dataeditor (Power Query), uden først at anvende disse ændringer på datamodellen.

Billede, der viser dialogboksen Anvend ændring af forespørgsel.

Når du vælger Anvend senere, gemmes de ændringer, der ikke er anvendt, i den unappliedChanges.json fil. Når ventende ændringer er i filen unappliedChanges, beder Power BI Desktop dig om at anvende eller kassere de ventende ændringer:

Billede, der viser advarsel om ventende ændringer.

Hvis du vælger Anvend ændringer, overskriver Power BI Desktop forespørgslerne i semantiske modelmetadata med forespørgslerne fra unappliedChanges.json. Hvis du har redigeret forespørgsler uden for Power BI Desktop, og der er en tidligere unappliedChanges.json fil, går dine ændringer tabt og erstattes af forespørgslerne i unappliedChanges.json, når disse ændringer anvendes.

Filen unappliedChanges.json inkorporeres automatisk i definitionen af den semantiske model og gemmes som standard i Git. Dette giver dig mulighed for at sende dit igangværende arbejde til udviklingsgrenen, der fungerer som en sikkerhedskopi og gør den tilgængelig for andre teammedlemmer. Du kan dog udelade denne fil fra Gits sporing, hvilket forhindrer, at uafsluttet forespørgselsarbejde påvirker andre udviklere.

Du kan få flere oplysninger i skemadokumentet unappliedChanges.json.

definition.pbism

Indeholder den overordnede definition af en semantisk model og kerneindstillinger.

Denne fil angiver også de understøttede semantiske modeldefinitionsformater via egenskaben 'version'.

Version Understøttede formater
1.0 Semantisk modeldefinition skal gemmes som TMSL i filen model.bim.
4.0 eller nyere Semantisk modeldefinition kan gemmes som TMSL (model.bim-fil) eller TMDL (\definitionsmappe).

Du kan få flere oplysninger i skemadokumentet definition.pbism.

model.bim

Denne fil er kun tilgængelig, hvis Power BI-projektet er gemt i TMSL-formatet. Den indeholder en objektdefinition af projektmodellen i TMSL-databasen (Tabular Model Scripting Language).

definition\ mappe

Denne mappe er kun tilgængelig, hvis Power BI-projektet er gemt i TMDL-formatet. Den erstatter filen model.bim .

Denne mappe indeholder en TMDL-databaseobjektdefinition (Tabular Model Definition Language)for projektmodellen.

diagramLayout.json

Indeholder diagrammetadata, der definerer strukturen af den semantiske model, der er knyttet til rapporten. Du kan ikke redigere denne fil eksternt.

.perron

Fabric-platformfil, der indeholder egenskaber, der er vigtige for at etablere og vedligeholde forbindelsen mellem Fabric-elementer og Git.

Du kan få mere at vide under Automatisk genererede systemfiler til Git-integration.

DAXQueries\-mappen

Indeholder en fil for hver DAX-forespørgselsvisningsfane , gemt som en [Tab name].dax DAX-fil.

.pbi\daxQueries.jspå

Indeholder DAX forespørgselsvisningseditor-indstillinger såsom defaultTab eller tabulatorrækkefølge.

TMDLScripts\-mappen

Indeholder en fil for hver TMDL-visningsscriptfane , gemt som en [Tab name].tmdl TMDL-fil.

.pbi\tmdlscripts.jspå

Indeholder TMDL-visningsredigeringsindstillinger såsom defaultTab eller fanerækkefølge.

TMDL-format

Med det formål at give en bedre kildekontrol og samtidig udvikling kan du gemme dine Power BI Project-filer (PBIP) ved hjælp af TMDL (Tabular Model Definition Language) som filformat for semantisk model.

I modsætning til TMSL (Tabular Model Scripting Language) er TMDL blevet designet fra bunden til at være menneskeligt brugervenligt, hvilket letter ikke kun læsbarheden , men også nem redigering i enhver teksteditor. Dette repræsenterer en væsentlig forbedring af kildestyring og samarbejdsudviklingsoplevelser .

Skærmbillede af brugervenlige TMDL-sammenligninger.

I stedet for en stor JSON-fil, f.eks. TMSL (Tabular Model Scripting Language), har TMDL en mappestruktur med separate filer for hver tabel, hvert perspektiv, hver rolle og kultur. Det gør det nemmere at arbejde med andre og forstå den semantiske modelstruktur ved blot at se på mappen og filerne. I sidste ende fører dette til en fantastisk kildekontrol og samarbejdsudviklingsoplevelse, når du arbejder med git diff's og flette konflikter.

Skærmbillede af semantisk model-TMDL-sammenligninger.

Få mere at vide om TMDL her.

Foretag eksterne ændringer af TMDL-filer

Du kan redigere TMDL-filer i Visual Studio Code eller et andet eksternt værktøj, mens projektet forbliver åbent i Power BI Desktop. Hvis du vil have en bedre TMDL-redigeringsoplevelse, skal du installere TMDL-udvidelsen til Visual Studio Code.

Før du redigerer filerne eksternt, skal du gemme eventuelle ændringer i Power BI Desktop. Åbn mappen PBIP i VS Code, naviger til mappen med semantiske modeller definition , og gem dine TMDL-ændringer. Power BI Desktop registrerer de gemte ændringer og viser banneret Anvend eksterne ændringer. Vælg Anvend eksterne ændringer for at genindlæse den semantiske model uden at lukke og genåbne projektet.

Skærmbillede af en semantisk modeldefinitionsmappe i VS Code.

Hvis Power BI Desktop har ændringer, der ikke er gemt, bliver du advaret om, at hvis du anvender de eksterne ændringer, overskrives de. Du kan se hele arbejdsprocessen og begrænsningerne under Rediger PBIP-filer uden for Power BI Desktop.

Du kan se understøttede skrivehandlinger uden for Power BI Desktop under Oprettelse af model.

TMDL-fejl

Hvis en TMDL-redigering er ugyldig, vises der en fejl i Power BI Desktop, når du anvender de eksterne ændringer eller åbner projektet. Fejlen identificerer den placering, du skal rette, før Power BI Desktop kan indlæse den opdaterede semantiske model:

Skærmbillede af en fejlmeddelelse for en ugyldig fil.