Share via

Mappe med semantisk model til Power BI Desktop-projekt

  • Artikel

Vigtigt

Power BI Desktop-projekter er i øjeblikket en prøveversion.

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\local Indstillinger.json

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 det lokale skemadokument Indstillinger.json.

.pbi\editor Indstillinger.json

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 editoren Indstillinger.json skemadokument.

.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 indholdet i model.bim.

.pbi\unappliedChanges.json

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 model.bim med forespørgslerne fra unappliedChanges.json. Hvis du har redigeret forespørgsler i model.bim 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 fil er kun tilgængelig, hvis Power BI-projektet er gemt i TMDL-formatet. Den erstatter filen model.bim .

Denne fil 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. Under PRØVEVERSIONen understøtter denne fil ikke ekstern redigering.

.Platform

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.

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.

Aktivér prøveversionsfunktionen TMDL-format

Lagring som et Power BI-projekt ved hjælp af TMDL er i øjeblikket en prøveversion. Før du bruger den, skal du først aktivere den i prøveversionsfunktioner:

Gå til Filindstillinger >> Indstillinger > Prøveversionsfunktioner, og markér afkrydsningsfeltet ud for Gem semantisk model ved hjælp af TMDL-format.

Gem som et projekt ved hjælp af TMDL

Når funktionen TMDL Preview er aktiveret, gemmes din semantiske model som en TMDL-mappe med navnet \definition i mappen semantisk model, når du gemmer et projekt:

Skærmbillede af definitionsmappen i en semantisk modelmappe.

Få mere at vide om TMDL-mappestrukturen.

Konvertér eksisterende PBIP til TMDL

Hvis du allerede har et PBIP ved hjælp af TMSL som semantisk modelformat, kan du konvertere det til TMDL på følgende måde:

  1. Åbn PBIP i Power BI Desktop.

  2. Sørg for, at prøveversionsfunktionen er aktiveret.

  3. Gem projektet. Der vises en prompt, hvor du bliver bedt om at opgradere til TMDL.

  4. Vælg Opgrader.

    Vigtigt

    Når du opgraderer til TMDL, kan du ikke vende tilbage til TMSL. Hvis du mener, at du måske vil vende tilbage til TMSL, skal du først gemme en kopi af dine PBIP-filer.

    Skærmbillede af prompten om at opgradere semantisk modelmappe til TMDL.

Den eksisterende TMSL-fil (Tabular Model Scripting Language) (model.bim) erstattes af en \definition-mappe , der indeholder TMDL-repræsentationen af den semantiske model.

Skærmbillede af PBIP-projekter med TMSL-mapper og med TMDL-mapper.

Hvis du vælger at beholde det aktuelle format, bliver desktop ikke bedt om at opgradere igen.

Foretag eksterne ændringer af TMDL-filer

Hvis du vil have en bedre oplevelse med at læse og redigere dine TMDL-filer, skal du installere udvidelsen TMDL - Visual Studio Marketplace Microsoft VS Code.

Åbn PBIP-mappen ved hjælp af VS Code, og naviger til mappen semantisk modeldefinition.

Skærmbillede af en semantisk modeldefinitionsmappe i VS Code.

Power BI Desktop er ikke opmærksom på ændringer af projektfiler, der er foretaget af andre værktøjer. Hvis du derfor foretager ændringer af åbne filer uden for Power BI Desktop, skal du genstarte, før disse ændringer vises i Power BI Desktop.

Se her for understøttede skrivehandlinger uden for Power BI Desktop.

TMDL-fejl

Hvis der foretages ugyldige ændringer af TMDL-filerne, udløser Power BI Desktop en fejl ved åbning med placeringen af fejlen:

Skærmbillede af en fejlmeddelelse for en ugyldig fil.

Fabric Git Integration med TMDL

Under den offentlige prøveversion eksporterer Fabric Git Integration stadig den semantiske model ved hjælp af TMSL som standard. Men hvis den semantiske model importeres til Fabric ved hjælp af Fabric Git Integration med TMDL-format, bruger Fabric Git Integration TMDL-formatet til at eksportere den semantiske modeldefinition til Git, hvis der er ændringer af semantiske modeller i tjenesten.

Vigtigt

Hvis du importerer din semantiske model ved hjælp af en anden importmetode, f.eks . Power BI Desktop Publish, skifter Fabric Git Integration tilbage til TMSL-standardformatet.

Relateret indhold