Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Tässä artikkelissa kuvataan Microsoft Power BI Desktop -projektin Semanttinen malli -kansion tiedostot ja alikansiot. Tässä olevat tiedostot ja alikansiot edustavat Power BI:n semanttista mallia. Projektistasi riippuen semanttinen mallikansio voi olla seuraava:
- .pbi\
- DAXQueries\ kansio
- TMDLScripts\ kansio
- määritelmä\ kansio3
- model.bim2
- diagramLayout.json
- .lava
- definition.pbism1
1 – Tämä tiedosto vaaditaan.
2 – Tämä tiedosto vaaditaan tallennettaessa TMSL-muotoa käyttäen.
3 – Tämä tiedosto vaaditaan tallennettaessa TMDL-muotoa käyttäen.
Kaikki projektin semanttiset mallikansiot eivät sisällä kaikkia tässä kuvattuja tiedostoja ja alikansioita.
Semanttiset mallitiedostot
.pbi\localSettings.jskäytössä
Sisältää semanttisen mallin asetukset, jotka koskevat vain nykyistä käyttäjää ja tietokonetta. Se tulee sisällyttää GitIgnoreen tai muihin lähdekoodin hallinnan ulkopuolelle. Git ohittaa tämän tiedoston oletusarvoisesti.
Lisätietoja on localSettings.json rakenneasiakirjassa.
.pbi\editorSettings.jskäytössä
Sisältää semanttisen mallieditorin asetukset, jotka on tallennettu osana semanttista mallin määritystä käytettäväksi kaikissa käyttäjissä ja ympäristöissä.
Lisätietoja on editorSettings.json rakenneasiakirjassa.
.pbi\cache.abf
Analysis Services Backup (ABF) -tiedosto, joka sisältää mallin ja tietojen paikallisen välimuistiin tallennetun kopion, kun sitä viimeksi muokattiin. Se tulee sisällyttää GitIgnoreen tai muihin lähdekoodin hallinnan ulkopuolelle. Git ohittaa tämän tiedoston oletusarvoisesti.
Power BI Desktop voi avata projektin ilman cache.abf-tiedostoa. Siinä tapauksessa se avaa raportin, joka on yhdistetty malliin, jossa on koko määritys mutta ei tietoja. Jos cache.abf on olemassa, Power BI Desktop lataa tiedot ja korvaa mallin määrityksen projektin semanttisella mallin metatiedoilla.
.pbi\unappliedChanges.jskäytössä
Power BI Desktopin avulla voit tallentaa Muunna tiedot -editorissa (Power Query) tehdyt muutokset ilman, että kyseisiä muutoksia otetaan ensin käyttöön tietomallissa.
Kun valitset myöhemmin Käytä, muutokset, joita ei ole tehty, tallennetaan unappliedChanges.json tiedostoon. Kun odottavat muutokset ovat käyttämättömässä Vaihda-tiedostossa, Power BI Desktop kehottaa sinua soveltamaan tai hylkäämään odottavat muutokset:
Jos valitset Ota muutokset käyttöön, Power BI Desktop korvaa semanttisen mallin metatiedoissa olevat kyselyt unappliedChanges.jsonkyselyillä. Jos muokkasit kyselyitä Power BI Desktopin ulkopuolella ja saatavilla on aiempi unappliedChanges.json -tiedosto, tekemäsi muutokset menetetään ja korvataan kyselyillä unappliedChanges.json, kun muutokset otetaan käyttöön.
unappliedChanges.json tiedosto sisältyy automaattisesti semanttisen mallin määritykseen ja tallennetaan oletusarvoisesti Git-palveluun. Näin voit sitouttaa jatkuvan työsi kehityshaaraan, joka toimii varmuuskopiona, ja tehdä siitä muiden tiimin jäsenten käytettävissä. Voit kuitenkin sulkea tämän tiedoston pois Gatin seurannasta estäen keskeneräisen kyselytyön pääsyn muihin kehittäjiin.
Lisätietoja on unappliedChanges.json rakenneasiakirjassa.
definition.pbism
Sisältää semanttisen mallin yleisen määrityksen ja perusasetukset.
Tämä tiedosto määrittää myös tuetut semanttisen mallin määritysmuodot version -ominaisuuden kautta.
| Versio | Tuetut muodot |
|---|---|
| 1.0 | Semanttisen mallin määritys on tallennettava TMSL-muodossa model.bim-tiedostoon. |
| 4.0 tai uudempi | Semanttisen mallin määritykset voidaan tallentaa TMSL:nä (model.bim-tiedosto) tai TMDL:nä (\definition-kansio). |
Lisätietoja on definition.pbism-rakenneasiakirjassa.
model.bim
Tämä tiedosto on käytettävissä vain, jos Power BI -projekti tallennetaan TMSL-muodossa. Se sisältää TMSL(Tabular Model Scripting Language) -tietokantaobjektin määrityksen projektimallille.
definition\ kansio
Tämä kansio on käytettävissä vain, jos Power BI -projekti tallennetaan TMDL-muodossa. Se korvaa model.bim-tiedoston .
Tämä kansio sisältää TMDL (Tabular Model Definition Language)-tietokantaobjektin määrityksen projektimallille.
diagramLayout.json
Sisältää kaavion metatiedot, jotka määrittävät raporttiin liittyvän semanttisen mallin rakenteen. Et voi muokata tätä tiedostoa ulkoisesti.
.lava
Fabric-alustatiedosto, joka sisältää Fabric-kohteiden ja Gitin välisen yhteyden muodostamisen ja ylläpitämisen kannalta olennaiset ominaisuudet.
Lisätietoja on artikkelissa Git-integrointi automaattisesti luodut järjestelmätiedostot.
DAXQueries\ kansio
Sisältää tiedoston jokaiselle DAX-kyselynäkymän kyselyvälilehdelle, tallennettuna [Tab name].dax DAX-tiedostona.
.pbi\daxQueries.jspäällä
Sisältää DAX-kyselynäkymän editorin asetukset, kuten defaultTab tai tab-järjestys.
TMDLScripts\ kansio
Sisältää tiedoston jokaiselle TMDL-näkymän skriptivälilehdelle, tallennettuna [Tab name].tmdl TMDL-tiedostona.
.pbi\tmdlscripts.jspäällä
Sisältää TMDL-näkymän editorin asetukset, kuten defaultTab tai tab-järjestys.
TMDL-muoto
Koska haluat tarjota paremman lähdekoodin hallinnan ja rinnakkaiskehityskokemuksen, voit tallentaa Power BI Project -tiedostot (PBIP) käyttämällä semanttisen mallin tiedostomuotona Taulukkomallin määrityskieltä (TMDL).
Toisin kuin TMSL (Tabular Model Scripting Language), TMDL on suunniteltu alusta alkaen niin, että se on käyttäjäystävällinen, mikä helpottaa paitsi luettavuutta myös helppoa muokkaamista missä tahansa tekstieditorissa. Tämä merkitsee huomattavaa parannusta lähteen hallintaan ja yhteistyökehitykseen .
TMDL:ssä on TMSL:n (Tabular Model Scripting Language) kaltaisen suuren JSON-tiedoston sijaan kansiorakenne, jossa on erilliset tiedostot kullekin taulukolle, perspektiiville, roolille ja kulttuurille. Tämä helpottaa työskentelyä muiden kanssa ja semanttisen mallin rakenteen ymmärtämistä tarkastelemalla kansiota ja tiedostoja. Tämä johtaa lopulta erinomaiseen lähteen hallintaan ja yhteiskehitykseen Git diff:n ja yhdistämisristiriitojen kanssa.
Lisätietoja TMDL: stä on täällä.
Tee ulkoisia muutoksia TMDL-tiedostoihin
Voit muokata TMDL-tiedostoja Visual Studio Code tai toisessa ulkoisessa työkalussa, kun projekti pysyy avoimena Power BI Desktopissa. TMDL-muokkauskokemuksen parantamiseksi asenna TMDL-laajennus Visual Studio Code varten.
Ennen kuin muokkaat tiedostoja ulkoisesti, tallenna muutokset Power BI Desktopiin. Avaa PBIP-kansio VS Codessa, siirry semanttisen mallin definition kansioon ja tallenna TMDL-muutokset. Power BI Desktop havaitsee tallennetut muutokset ja näyttää Ota ulkoiset muutokset käyttöön -bannerin. Valitse Ota ulkoiset muutokset käyttöön , jos haluat ladata semanttisen mallin uudelleen sulkematta ja avaamatta projektia uudelleen.
Jos Power BI Desktopissa on tallentamattomia muutoksia, se varoittaa, että ulkoisten muutosten käyttäminen korvaa ne. Katso koko työnkulku ja rajoitukset kohdasta PBIP-tiedostojen muokkaaminen Power BI Desktopin ulkopuolella.
Jos haluat tukea kirjoitustoimintoja Power BI Desktopin ulkopuolella, katso Mallin luominen.
TMDL-virheet
Jos TMDL-muokkaus on virheellinen, Power BI Desktop näyttää virheen, kun otat ulkoisia muutoksia käyttöön tai avaat projektin. Virhe tunnistaa sijainnin, joka sinun on korjattava, ennen kuin Power BI Desktop voi ladata päivitetyn semanttisen mallin:
