Priečinok sémantického modelu projektu v aplikácii Power BI Desktop
Dôležité
Projekty aplikácie Power BI Desktop sú v súčasnosti vo verzii Preview.
Tento článok popisuje súbory a podpriečinky v priečinku sémantického modelu projektu Microsoft Power BI Desktop. Súbory a podpriečinky v tomto priečinku predstavujú sémantický model služby Power BI. V závislosti od projektu môže priečinok sémantických modelov obsahovať:
1 – Tento súbor je povinný.
2 – Tento súbor sa vyžaduje pri ukladaní pomocou formátu TMSL.
3 – Tento súbor sa vyžaduje pri ukladaní pomocou formátu TMDL.
Nie každý priečinok sémantického modelu projektu neobsahuje všetky súbory a podpriečinky popísané v tomto článku.
Súbory sémantického modelu
.pbi\localSettings.json
Obsahuje sémantické nastavenia modelu, ktoré sa vzťahujú iba na aktuálneho používateľa a počítač. Mala by sa zahrnúť do vylúčenia gitIgnore alebo iného vylúčenia správy zdrojov. Predvolene Git tento súbor ignoruje.
Ďalšie informácie nájdete v dokumente localSettings.json schému.
.pbi\editorSettings.json
Obsahuje nastavenia editora sémantických modelov uložené ako súčasť definície sémantického modelu na použitie medzi používateľmi a prostrediami.
Ďalšie informácie nájdete v dokumente editorSettings.json schému.
.pbi\cache.abf
Súbor Analysis Services Backup (ABF), ktorý obsahuje kópiu modelu a údajov uložených vo vyrovnávacej pamäti pri poslednej úprave. Mala by sa zahrnúť do vylúčenia gitIgnore alebo iného vylúčenia správy zdrojov. Predvolene Git tento súbor ignoruje.
Aplikácia Power BI Desktop môže otvoriť projekt bez súboru cache.abf. V takom prípade otvorí zostavu pripojenú k modelu s celou definíciou, ale bez údajov. Ak cache.abf existuje, Power BI Desktop načíta údaje a prepíše definíciu modelu obsahom v súbore model.bim.
.pbi\unappliedChanges.json
Power BI Desktop umožňuje uložiť zmeny vykonané v editore Transformovať údaje (Power Query) bez toho, aby ste tieto zmeny najskôr vykonali v dátovom modeli.
Po výbere možnosti Použiť sa nepoužiné zmeny uložia do súboru unappliedChanges.json. Keď sú nevybavené zmeny v súbore UnappliedChanges, aplikácia Power BI Desktop zobrazí výzvu na uplatnenie alebo zahodenie čakajúcich zmien:
Ak vyberiete možnosť Použiť zmeny, Power BI Desktop prepíše dotazy v súbore model.bim s dotazmi z unappliedChanges.json. Ak ste upravili dotazy v súbore model.bim mimo aplikácie Power BI Desktop a existuje predchádzajúci unappliedChanges.json súbor, vaše zmeny sa pri použití zmien stratia a nahradia dotazmi v unappliedChanges.json.
Súbor unappliedChanges.json sa automaticky začleni do definície sémantického modelu a predvolene uložený v Git. Umožní vám to potvrdiť prebiehajúcu prácu do vetvy vývoja, ktorá slúži ako záloha a sprístupňuje ju ostatným členom tímu. Tento súbor však môžete vylúčiť zo sledovania v službe Git, čím sa zabráni tomu, aby nedokončená práca dotazu neovplyvňovala ostatných vývojárov.
Ďalšie informácie nájdete v dokumente unappliedChanges.json schému.
definition.pbism
Obsahuje celkovú definíciu sémantického modelu a základných nastavení.
Tento súbor tiež špecifikuje podporované formáty sémantických definícií modelu prostredníctvom vlastnosti "verzia".
| Verzia | Podporované formáty |
|---|---|
| 1.0 | Definícia sémantického modelu musí byť uložená ako TMSL v súbore model.bim. |
| 4.0 alebo vyššia | Definíciu sémantického modelu možno uložiť ako TMSL (súbor model.bim) alebo TMDL (\priečinok definície). |
Ďalšie informácie nájdete v dokumente schéma definition.pbism.
model.bim
Tento súbor je k dispozícii iba v prípade, že projekt Power BI je uložený vo formáte TMSL. Obsahuje definíciu objektu databázy jazyka na skriptovanie tabuľkového modelu (TMSL) modelu projektu.
folder\
Tento priečinok je k dispozícii iba v prípade, že projekt Power BI je uložený pomocou formátu TMDL. Nahradí súbor model.bim.
Tento priečinok obsahuje definíciu objektu databázy tabuľkového modelu (TMDL) modelu projektu.
diagramLayout.json
Obsahuje metaúdaje diagramu, ktoré definujú štruktúru sémantického modelu priradeného k zostave. Počas používania ukážky tento súbor nepodporuje externé úpravy.
.nástupište
Súbor platformy fabric, ktorý obsahuje vlastnosti dôležité pre vytvorenie a zachovanie prepojenia medzi položkami služby Fabric a službou Git.
Ďalšie informácie nájdete v téme Integrácia systému Git automaticky generované systémové súbory.
Formát TMDL
S cieľom zabezpečiť lepšiu kontrolu zdrojov a skúsenosti s vaším vývojom môžete ukladať súbory projektov Power BI (PBIP) pomocou jazyka definície tabuľkového modelu (TMDL) ako formátu súboru sémantického modelu.
Na rozdiel od tabuľkového modelu Scripting Language (TMSL), TMDL bol navrhnutý tak, aby bol priateľský k ľuďom, čím sa uľahčuje nielen čitateľnosť , ale aj jednoduché úpravy v každom textovom editore. To predstavuje podstatné zlepšenie prostredia na kontrolu zdrojov a spoluprácu pri vývoji.
Namiesto veľkého súboru JSON, ako je napríklad Jazyk na skriptovanie tabuľkového modelu (TMSL), má TMDL štruktúru priečinkov so samostatnými súbormi pre každú tabuľku, perspektívu, rolu a kultúru. Tým sa zjednoduší práca s ostatnými používateľmi a porozumiete štruktúre sémantického modelu len tak, že sa pozriete na priečinok a súbory. V konečnom dôsledku to vedie k skvelej kontrole zdrojov a skúsenosti spolurozhodovania pri riešení git diff a zlúčení konfliktov.
Ďalšie informácie o TMDL nájdete tu.
Povolenie funkcie ukážky formátu TMDL
Ukladanie ako projekt Power BI pomocou TMDL je momentálne vo verzii Preview. Pred použitím ju musíte najprv povoliť vo funkciách verzie Preview:
Prejdite na položky Súbor > Možnosti a nastavenia > Možnosti > Funkcie ukážky a začiarknite políčko vedľa položky Store sémantický model pomocou formátu TMDL.
Uložiť ako projekt pomocou TMDL
Keď je povolená funkcia TMDL Preview, po uložení projektu sa váš sémantický model uloží ako priečinok TMDL s názvom \definition v rámci priečinka sémantického modelu:
Ďalšie informácie o štruktúre priečinkov TMDL.
Konverzia existujúceho súboru PBIP na TMDL
Ak už máte PBIP, ktorý používa formát TMSL ako sémantický formát modelu, môžete ho skonvertovať na TMDL takto:
Otvorte súbor PBIP v aplikácii Power BI Desktop.
Uistite sa, že funkcia vo verzii ukážky je povolená.
Uložte projekt. Zobrazí sa výzva so žiadosťou o inováciu na TMDL.
Vyberte položku Inovovať.
Dôležité
Po inovácii na TMDL sa nemôžete vrátiť späť na TMSL. Ak si myslíte, že sa môžete vrátiť späť na knižnicu TMSL, uložte najskôr kópiu súborov PBIP.
Existujúci súbor tabuľkového modelu Scripting Language (TMSL) (model.bim) sa nahradí priečinkom \definition obsahujúcim vyjadrenie TMDL sémantického modelu.
Ak vyberiete možnosť Zachovať aktuálny formát, aplikácia Desktop nebude znova vyzvúkať inovovať.
Vykonanie externých zmien v súboroch TMDL
Ak chcete mať lepšie možnosti čítania a úpravy súborov TMDL, nainštalujte si rozšírenie TMDL – Visual Studio Marketplace Microsoft VS Code.
Otvorte priečinok PBIP pomocou nástroja VS Code a prejdite do priečinka definície sémantického modelu.
Aplikácia Power BI Desktop nemá informácie o zmenách súborov projektov, ktoré vykonali iné nástroje. Preto ak vykonáte nejaké zmeny na otváranie súborov mimo aplikácie Power BI Desktop, musíte vykonať reštartovanie, aby sa tieto zmeny zobrazili v aplikácii Power BI Desktop.
Podporované operácie zapisovania mimo aplikácie Power BI Desktop nájdete tu .
Chyby TMDL
Ak sa v súboroch TMDL vykonajú neplatné úpravy, aplikácia Power BI Desktop zobrazí pri otvorení chybu s umiestnením chyby:
Dôležité informácie a obmedzenia týkajúce sa TMDL
Počas verejnej ukážky bude integrácia systému Fabric Git naďalej exportovať sémantický model pomocou predvoleného nastavenia TMSL. Ak sa však sémantický model importuje do služby Fabric pomocou integrácie Git tkaniny s formátom TMDL, potom integrácia služby Fabric Git použije formát TMDL na export sémantickej definície modelu do Git, ak v službe dôjde k zmenám sémantických modelov.
Dôležité
Ak importujete sémantický model pomocou ľubovoľnej inej metódy importu, ako je napríklad publikovanie aplikácie Power BI Desktop, integrácia Git služby Fabric sa prepne späť na predvolený formát TMSL.