Semantisk modellmappe for Power BI Desktop-prosjektet

Denne artikkelen beskriver filene og undermappene i Semantic Model-mappen til et Microsoft Power BI Desktop-prosjekt. Filene og undermappene her representerer en semantisk Power BI-modell. Avhengig av prosjektet kan den semantiske modellmappen inkludere:

1 – Denne filen kreves.
2 – Denne filen kreves når du lagrer ved hjelp av TMSL-format.
3 – Denne filen kreves når du lagrer ved hjelp av TMDL-format.

Ikke alle project semantic model-mapper inneholder alle filene og undermappene som er beskrevet her.

Semantiske modellfiler

PBI-\localSettings.jspå

Inneholder semantiske modellinnstillinger som bare gjelder for gjeldende bruker og datamaskin. Den bør inkluderes i gitIgnore eller andre utelukkelser for kildekontroll. Som standard ignorerer Git denne filen.

Hvis du vil ha mer informasjon, kan du se localSettings.json skjemadokument.

PBI-\editorSettings.jspå

Inneholder innstillinger for semantisk modellredigering som er lagret som en del av den semantiske modelldefinisjonen for bruk på tvers av brukere og miljøer.

Hvis du vil ha mer informasjon, kan du se editorSettings.json skjemadokument.

.pbi\cache.abf

En Analysis Services Backup -fil (ABF) som inneholder en lokal hurtigbufret kopi av modellen og dataene da den sist ble redigert. Den bør inkluderes i gitIgnore eller andre utelukkelser for kildekontroll. Som standard ignorerer Git denne filen.

Power BI Desktop kan åpne et prosjekt uten en cache.abf-fil. I så fall åpnes rapporten som er koblet til en modell med hele definisjonen, men uten data. Hvis det finnes en cache.abf, laster Power BI Desktop inn dataene og overskriver modelldefinisjonen med de semantiske modellmetadataene i prosjektet.

PBI-\unappliedChanges.jspå

Med Power BI Desktop kan du lagre endringer som er gjort i redigeringsprogrammet for transformering av data (Power Query), uten først å bruke disse endringene i datamodellen.

Bilde som viser dialogboksen Bruk spørringsendring.

Når du velger Bruk senere, lagres de ikke-tilordnede endringene i unappliedChanges.json-filen. Når ventende endringer er i filen unappliedChanges, ber Power BI Desktop deg om å bruke eller forkaste de ventende endringene:

Bilde som viser advarsel om ventende endringer.

Hvis du velger Bruk endringer, overskriver Power BI Desktop spørringene i semantiske modellmetadata med spørringene fra unappliedChanges.json. Hvis du redigerte spørringer utenfor Power BI Desktop og det finnes en tidligere unappliedChanges.json fil, går endringene tapt og erstattes av spørringene i unappliedChanges.json når disse endringene brukes.

Den unappliedChanges.json filen blir automatisk innlemmet i den semantiske modelldefinisjonen og lagres i Git som standard. Dette gjør at du kan utføre det pågående arbeidet til utviklingsgrenen, som fungerer som en sikkerhetskopi og gjøre det tilgjengelig for andre teammedlemmer. Du kan imidlertid utelate denne filen fra Gits sporing, noe som hindrer at uferdig spørringsarbeid påvirker andre utviklere.

Hvis du vil ha mer informasjon, kan du se unappliedChanges.json skjemadokument.

definition.pbism

Inneholder den generelle definisjonen av en semantisk modell og kjerneinnstillinger.

Denne filen angir også de støttede semantiske modelldefinisjonsformatene gjennom versjonsegenskapen.

Versjon Støttede formater
1.0 Semantisk modelldefinisjon må lagres som TMSL i model.bim-filen.
4.0 eller nyere Semantisk modelldefinisjon kan lagres som TMSL (model.bim-fil) eller TMDL (\definisjonsmappe).

Hvis du vil ha mer informasjon, kan du se xml-skjemadokumentet definition.pbism.

model.bim

Denne filen er bare tilgjengelig hvis Power BI-prosjektet lagres ved hjelp av TMSL-formatet. Den inneholder en objektdefinisjon for tabellmodellskripting (TMSL) for prosjektmodellen.

definisjon\ mappe

Denne mappen er bare tilgjengelig hvis Power BI-prosjektet lagres ved hjelp av TMDL-formatet. Den erstatter model.bim-filen .

Denne mappen inneholder en objektdefinisjon for tabellmodelldefinisjon (TMDL) for prosjektmodellen.

diagramLayout.json

Inneholder diagrammetadata som definerer strukturen til den semantiske modellen som er knyttet til rapporten. Du kan ikke redigere denne filen eksternt.

.plattform

Stoffplattformfil som inneholder egenskaper som er avgjørende for å etablere og vedlikeholde forbindelsen mellom Stoffelementer og Git.

Hvis du vil ha mer informasjon, kan du se Git-integrering automatisk genererte systemfiler.

DAXQueries\-mappen

Inneholder en fil for hver DAX-spørringsvisningsfane lagret som en [Tab name].dax DAX-fil.

.pbi\daxQueries.jspå

Inneholder innstillinger for DAX-forespørringsvisningseditoren som defaultTab eller tabulatorrekkefølge.

TMDLScripts\-mappen

Inneholder en fil for hver TMDL-visningsskriptfane lagret som en [Tab name].tmdl TMDL-fil.

.pbi\tmdlscripts.jspå

Inneholder TMDL-visningsredigeringsinnstillinger som defaultTab eller fanerekkefølge.

TMDL-format

Du kan lagre Power BI Project-filer (PBIP) ved hjelp av Tabellmodelldefinisjonsspråk (TMDL) som det semantiske modellfilformatet med målet om å gi en bedre kildekontroll og samtidig utvikling.

I motsetning til Tabular Model Scripting Language (TMSL), har TMDL blitt utformet fra grunnen av for å være menneskevennlig, noe som letter ikke bare lesbarhet , men også enkel redigering i et tekstredigeringsprogram. Dette representerer en betydelig forbedring for kildekontroll og samarbeidsutviklingsopplevelser .

Skjermbilde av egendefinerte TMDL-differ.

I stedet for en stor JSON-fil som Tabular Model Scripting Language (TMSL), har TMDL en mappestruktur med separate filer for hver tabell, perspektiv, rolle og kultur. Dette gjør det enklere å arbeide med andre og forstå den semantiske modellstrukturen ved bare å se på mappen og filene. Til syvende og sist fører dette til en flott kildekontroll- og samutviklingsopplevelse når du arbeider med git diff og slår sammen konflikter.

Skjermbilde av TMDL-differ for semantisk modell.

Mer informasjon om TMDL her.

Foreta eksterne endringer i TMDL-filer

Du kan redigere TMDL-filer i Visual Studio Code eller et annet eksternt verktøy mens prosjektet forblir åpent i Power BI Desktop. Hvis du vil ha en bedre TMDL-redigeringsopplevelse, installerer du TMDL-utvidelsen for Visual Studio Code.

Før du redigerer filene eksternt, lagrer du eventuelle endringer i Power BI Desktop. Åpne PBIP-mappen i VS Code, gå til den semantiske modellmappen definition og lagre TMDL-endringene. Power BI Desktop oppdager de lagrede endringene og viser banneret Bruk eksterne endringer. Velg Bruk eksterne endringer for å laste inn semantisk modell på nytt uten å lukke og åpne prosjektet på nytt.

Skjermbilde av en semantisk modelldefinisjonsmappe i VS Code.

Hvis Power BI Desktop har endringer som ikke er lagret, advarer den deg om at bruk av de eksterne endringene vil overskrive dem. Hvis du vil ha en fullstendig arbeidsflyt og begrensninger, kan du se Redigere PBIP-filer utenfor Power BI Desktop.

Hvis du vil ha støttede skriveoperasjoner utenfor Power BI Desktop, kan du se Modellredigering.

TMDL-feil

Hvis en TMDL-redigering er ugyldig, viser Power BI Desktop en feil når du bruker de eksterne endringene eller åpner prosjektet. Feilen identifiserer plasseringen du må rette før Power BI Desktop kan laste inn den oppdaterte semantiske modellen:

Skjermbilde av en feilmelding for en ugyldig fil.