Semanttinen Power BI Desktop -projektin kansio
Tärkeä
Power BI Desktop -projektit ovat tällä hetkellä esikatseluvaiheessa.
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:
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.json
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.json
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 model.bim-kohteen sisällöllä.
.pbi\unappliedChanges.json
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 model.bim-kyselyt unappliedChanges.json kyselyillä. Jos muokkasit kyselyitä model.bim-tiedostossa Power BI Desktopin ulkopuolella ja siellä on aiempi unappliedChanges.json -tiedosto, tekemäsi muutokset menetetään ja korvataan kyselyillä unappliedChanges.json kun näitä muutoksia 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ää taulukkomuotoisen mallin määrityskielen (TMDL) tietokantaobjektin määrityksen projektimallille.
diagramLayout.json
Sisältää kaavion metatiedot, jotka määrittävät raporttiin liittyvän semanttisen mallin rakenteen. Esikatselun aikana tämä tiedosto ei tue ulkoista muokkaamista.
.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.
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ä.
TMDL-muotoilun esikatselutoiminnon ottaminen käyttöön
Tallentaminen Power BI -projektina TMDL:n avulla on tällä hetkellä esikatseluvaiheessa. Ennen kuin käytät sitä, sinun on ensin otettava se käyttöön esikatselutoiminnoissa:
Valitse Tiedosto > Asetukset ja vaihtoehdot > Asetukset Esikatseluominaisuudet > ja valitse ruutu Kohdan Tallenna semanttinen malli käyttäen TMDL-muotoa vieressä.
Tallenna projektina TMDL:n avulla
Kun TMDL-esikatseluominaisuus on käytössä ja tallennat projektin, semanttinen mallisi tallennetaan TMDL-kansiona nimeltä \definition semanttisen mallin kansion sisällä:
Lue lisätietoja TMDL-kansiorakenteesta.
Muunna olemassa oleva PBIP TMDL:ksi
Jos sinulla on jo PBIP, joka käyttää TMSL:ää semanttisessa mallimuodossa, voit muuntaa sen TMDL:ksi seuraavasti:
Avaa PBIP Power BI Desktopissa.
Varmista, että esikatseluominaisuus on käytössä.
Tallenna projekti. Näyttöön tulee kehote, jossa sinua pyydetään päivittämään TMDL:ään.
Valitse Päivitä.
Tärkeä
Kun päivität TMDL:ään, et voi palata TMSL:ään. Jos haluat ehkä palauttaa TMSL:n, tallenna ensin kopio PBIP-tiedostoistasi.
Aiemmin luotu TMSL (Tabular Model Scripting Language) -tiedosto (model.bim) korvataan \definition-kansiolla, joka sisältää semanttisen mallin TMDL-esityksen.
Jos valitset Säilytä nykyinen muoto, Desktop ei kysy uudelleen päivittämistä.
Tee ulkoisia muutoksia TMDL-tiedostoihin
Voit lukea ja muokata TMDL-tiedostojasi paremmin asentamalla TMDL- Visual Studio Marketplace Microsoft VS Code -laajennuksen.
Avaa PBIP-kansio VS Coden avulla ja siirry semanttisen mallin määrityskansioon.
Power BI Desktop ei ole tietoinen muiden työkalujen tekemiin projektitiedostoihin tehdyistä muutoksista. Jos siis teet muutoksia avataksesi tiedostoja Power BI Desktopin ulkopuolella, sinun on käynnistettävä muutokset uudelleen, jotta nämä muutokset näytetään Power BI Desktopissa.
Katso täältä tuettuja kirjoitustoimintoja Power BI Desktopin ulkopuolella.
TMDL-virheet
Jos TMDL-tiedostoihin tehdään virheellisiä muokkauksia, Power BI Desktop aiheuttaa virheen ja näyttää virheen sijainnin:
TMDL:n huomioitavat asiat ja rajoitukset
Julkisen esikatselun aikana Fabric Git -integrointi vie semanttisen mallin oletusarvoisesti TMSL:n avulla. Jos semanttinen malli kuitenkin tuodaan Fabric Git -integroinnilla TMDL-muodon kanssa, Fabric Git -integrointi käyttää TMDL-muotoa semanttisen mallin määrityksen viemiseen Gitille, jos palvelussa on semanttisia mallimuutoksia.
Tärkeä
Jos tuot semanttisen mallin millä tahansa muulla tuontitavalla, kuten Power BI Desktopin Julkaisu-tavalla, Fabric Git -integrointi vaihtaa takaisin oletusarvoiseen TMSL-muotoon.