Semantisk modellmappe for Power BI Desktop-prosjektet
Viktig
Power BI Desktop-prosjekter er for øyeblikket i forhåndsversjon.
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.json
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.json
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 innholdet i model.bim.
.pbi\unappliedChanges.json
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.
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:
Hvis du velger Bruk endringer, overskriver Power BI Desktop spørringene i model.bim med spørringene fra unappliedChanges.json. Hvis du redigerte spørringer i model.bim 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. Denne filen støtter ikke ekstern redigering under FORHÅNDSVISNING.
.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.
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 .
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.
Mer informasjon om TMDL her.
Aktiver funksjonen forhåndsvisning av TMDL-format
Lagring som et Power BI-prosjekt ved hjelp av TMDL er for øyeblikket i forhåndsversjon. Før du bruker den, må du først aktivere den i forhåndsvisningsfunksjoner:
Gå til Filalternativer > og innstillinger > Alternativer > Forhåndsvisningsfunksjoner , og merk av for Store-semantisk modell ved hjelp av TMDL-format.
Lagre som et prosjekt ved hjelp av TMDL
Når funksjonen for forhåndsvisning av TMDL er aktivert, lagres den semantiske modellen som en TMDL-mappe med navnet \definition i den semantiske modellmappen:
Mer informasjon om TMDL-mappestruktur.
Konverter eksisterende PBIP til TMDL
Hvis du allerede har en PBIP som bruker TMSL som semantisk modellformat, kan du konvertere den til TMDL på følgende måte:
Åpne PBIP i Power BI Desktop.
Kontroller at forhåndsvisningsfunksjonen er aktivert.
Lagre prosjektet. Det vises en melding der du blir bedt om å oppgradere til TMDL.
Velg Oppgrader.
Viktig
Når du oppgraderer til TMDL, kan du ikke gå tilbake til TMSL. Hvis du tror du vil gå tilbake til TMSL, lagrer du en kopi av PBIP-filene først.
Den eksisterende TMSL-filen (Tabular Model Scripting Language) (model.bim) erstattes med en \definition-mappe som inneholder TMDL-representasjonen av den semantiske modellen.
Hvis du velger å beholde gjeldende format, blir ikke skrivebordsversjonen bedt om å oppgradere på nytt.
Foreta eksterne endringer i TMDL-filer
Hvis du vil ha en bedre opplevelse med å lese og redigere TMDL-filer, installerer du utvidelsen TMDL – Visual Studio Marketplace Microsoft VS Code.
Åpne PBIP-mappen ved hjelp av VS Code, og gå til semantisk modelldefinisjonsmappe.
Power BI Desktop er ikke klar over endringer i prosjektfiler som er gjort av andre verktøy. Hvis du gjør endringer for å åpne filer utenfor Power BI Desktop, må du derfor starte på nytt for at disse endringene skal vises i Power BI Desktop.
Se her for støttede skriveoperasjoner utenfor Power BI Desktop.
TMDL-feil
Hvis det gjøres ugyldige endringer i TMDL-filene, får Power BI Desktop en feil ved åpning, med plasseringen av feilen:
TMDL-hensyn og begrensninger
Under den offentlige forhåndsvisningen eksporterer Fabric Git Integration fortsatt den semantiske modellen ved hjelp av TMSL som standard. Men hvis den semantiske modellen importeres til Fabric ved hjelp av Fabric Git Integration med TMDL-format, vil Fabric Git Integration bruke TMDL-format til å eksportere den semantiske modelldefinisjonen til Git hvis det er noen semantiske modellendringer i tjenesten.
Viktig
Hvis du importerer den semantiske modellen ved hjelp av en annen importmetode, for eksempel Power BI Desktop Publish, går Fabric Git Integration tilbake til standard TMSL-format.