Del via


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.

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 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 .

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.

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:

Skjermbilde av definisjonsmappen i en semantisk modellmappe.

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:

  1. Åpne PBIP i Power BI Desktop.

  2. Kontroller at forhåndsvisningsfunksjonen er aktivert.

  3. Lagre prosjektet. Det vises en melding der du blir bedt om å oppgradere til TMDL.

  4. 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.

    Skjermbilde av ledetekst for å oppgradere semantisk modellmappe til TMDL.

Den eksisterende TMSL-filen (Tabular Model Scripting Language) (model.bim) erstattes med en \definition-mappe som inneholder TMDL-representasjonen av den semantiske modellen.

Skjermbilde av PBIP-prosjekter med TMSL-mapper og med TMDL-mapper.

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.

Skjermbilde av en semantisk modelldefinisjonsmappe i VS Code.

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:

Skjermbilde av en feilmelding for en ugyldig fil.

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.