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ť:

• .pbi\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• DAXQueries\ priečinok
• Priečinok TMDLScripts\
• definition\ priečinok³
• model.bim²
• diagramLayout.json
• .nástupište
• definition.pbism¹

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

\localSettings.js.pbi

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.

\editorSettings.js.pbi

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 metaúdajmi sémantického modelu v projekte.

\unappliedChanges.js.pbi

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 metaúdajoch sémantického modelu s dotazmi z unappliedChanges.json. Ak ste upravili dotazy mimo aplikácie Power BI Desktop a došlo k predchádzajúcemu unappliedChanges.json súboru, vaše zmeny sa po 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.

DAXQueries\ priečinok

Obsahuje súbor pre každú DAX záložku pohľadu dotazu uložený ako DAX súbor.[Tab name].dax

.pbi\daxQueries.jszapnuté

Obsahuje nastavenia editora pohľadov v DAX dotazoch , ako sú defaultTab alebo tab order.

Priečinok TMDLScripts\

Obsahuje súbor pre každú záložku TMDL view skriptu uložený ako [Tab name].tmdl TMDL súbor.

.pbi\tmdlscripts.jszapnuté

Obsahuje nastavenia TMDL view editora, ako je defaultTab alebo tab order.

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:

1. Otvorte súbor PBIP v aplikácii Power BI Desktop.

2. Uistite sa, že funkcia vo verzii ukážky je povolená.

3. Uložte projekt. Zobrazí sa výzva so žiadosťou o inováciu na TMDL.

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

Súvisiaci obsah

• Priečinok zostavy projektu aplikácie Power BI Desktop
• Projekty aplikácie Power BI Desktop
• Jazyk na skriptovanie tabuľkového modelu (TMSL)