Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
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\
- DAXQueries\ priečinok
- Priečinok TMDLScripts\
- definition\ priečinok3
- model.bim2
- diagramLayout.json
- .nástupište
- definition.pbism1
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. Tento súbor nemôžete externe upravovať.
.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.
Vykonanie externých zmien v súboroch TMDL
Súbory TMDL môžete upravovať v Visual Studio Code alebo inom externom nástroji, zatiaľ čo projekt zostane otvorený v aplikácii Power BI Desktop. Ak chcete mať lepší zážitok z úprav V TMDL, nainštalujte si rozšírenie TMDL pre Visual Studio Code.
Pred externou úpravou súborov uložte všetky zmeny v aplikácii Power BI Desktop. Otvorte priečinok PBIP v nástroji VS Code, prejdite do priečinka sémantických modelov definition a uložte zmeny TMDL. Power BI Desktop zistí uložené zmeny a zobrazí banner Použitie externých zmien. Ak chcete opätovne načítať sémantický model bez ukončenia a opätovného otvorenia projektu, vyberte položku Použiť externé zmeny .
Ak Power BI Desktop obsahuje neuložené zmeny, upozorní vás, že použitím externých zmien sa tieto zmeny prepíšu. Úplný pracovný postup a obmedzenia nájdete v téme Úprava súborov PBIP mimo aplikácie Power BI Desktop.
Podporované operácie zapisovania mimo aplikácie Power BI Desktop nájdete v téme Vytváranie modelov.
Chyby TMDL
Ak je úprava TMDL neplatná, Power BI Desktop zobrazí chybu pri použití externých zmien alebo otvorení projektu. Chyba identifikuje umiestnenie, ktoré musíte opraviť predtým, ako Power BI Desktop môže načítať aktualizovaný sémantický model:
