Složka sémantického modelu projektu Power BI Desktopu
Důležité
Projekty Power BI Desktopu jsou aktuálně ve verzi Preview.
Tento článek popisuje soubory a podsložky ve složce Semantic Model projektu Microsoft Power BI Desktopu. Zde uvedené soubory a podsložky představují sémantický model Power BI. V závislosti na projektu může složka sémantického modelu zahrnovat:
1 – Tento soubor je povinný.
2 – Tento soubor se vyžaduje při ukládání ve formátu TMSL.
3 – Tento soubor je vyžadován při ukládání pomocí formátu TMDL.
Ne každá složka sémantického modelu projektu obsahuje všechny soubory a podsložky popsané tady.
Sémantické soubory modelu
.pbi\localSettings.json
Obsahuje sémantická nastavení modelu, která platí pouze pro aktuálního uživatele a počítače. Měla by být zahrnuta v gitIgnore nebo jiných vyloučeních správy zdrojového kódu. Git ve výchozím nastavení tento soubor ignoruje.
Další informace najdete v dokumentu schématu localSettings.json.
.pbi\editorSettings.json
Obsahuje nastavení editoru sémantických modelů uložená jako součást definice sémantického modelu pro použití napříč uživateli a prostředími.
Další informace najdete v dokumentu schématu editorSettings.json.
.pbi\cache.abf
Soubor SLUŽBY Analysis Services Backup (ABF) obsahující místní kopii modelu a data uložená v mezipaměti, když byla naposledy upravena. Měla by být zahrnuta v gitIgnore nebo jiných vyloučeních správy zdrojového kódu. Git ve výchozím nastavení tento soubor ignoruje.
Power BI Desktop může otevřít projekt bez souboru cache.abf. V takovém případě otevře sestavu připojenou k modelu s celou definicí, ale bez dat. Pokud soubor cache.abf existuje, Power BI Desktop načte data a přepíše definici modelu obsahem v modelu.bim.
.pbi\unappliedChanges.json
Power BI Desktop umožňuje ukládat změny provedené v editoru transformovaných dat (Power Query), aniž byste tyto změny použili u datového modelu.
Když vyberete Použít později, neuplatněné změny se uloží do souboru unappliedChanges.json. Pokud jsou čekající změny v souboru unappliedChanges, Power BI Desktop vás vyzve, abyste tyto čekající změny použili nebo zahodili:
Pokud vyberete Možnost Použít změny, Power BI Desktop přepíše dotazy v model.bim dotazy z unappliedChanges.json. Pokud jste upravili dotazy v modelu.bim mimo Power BI Desktop a existuje předchozí soubor unappliedChanges.json, vaše změny se ztratí a nahradí dotazy v unappliedChanges.json při použití těchto změn.
Soubor unappliedChanges.json se automaticky začlení do definice sémantického modelu a ve výchozím nastavení se uloží do Gitu. To vám umožní potvrdit probíhající práci do vývojové větve, která slouží jako záloha a zpřístupnit ji ostatním členům týmu. Tento soubor ale můžete vyloučit ze sledování Gitu a zabránit tak tomu, aby nedokončená práce s dotazy ovlivnila jiné vývojáře.
Další informace najdete v dokumentu schématu unappliedChanges.json.
definition.pbism
Obsahuje celkovou definici sémantického modelu a základního nastavení.
Tento soubor také určuje podporované formáty definice sémantického modelu prostřednictvím vlastnosti version.
| Verze | Podporované formáty |
|---|---|
| 1.0 | Definice sémantického modelu musí být uložena jako TMSL v souboru model.bim. |
| 4.0 nebo vyšší | Definice sémantického modelu se dá uložit jako TMSL (soubor model.bim) nebo TMDL (\definition folder). |
Další informace naleznete v dokumentu schématu definition.pbism.
model.bim
Tento soubor je k dispozici pouze v případě, že je projekt Power BI uložený ve formátu TMSL. Obsahuje definici databázového objektu jazyka TMSL (Tabular Model Scripting Language) modelu projektu.
definition\ folder
Tato složka je dostupná jenom v případě, že je projekt Power BI uložený ve formátu TMDL. Nahradí soubor model.bim.
Tato složka obsahuje definici databázového objektu TMDL (Tabular Model Definition Language) modelu projektu.
diagramLayout.json
Obsahuje metadata diagramu, která definují strukturu sémantického modelu přidruženého k sestavě. Ve verzi PREVIEW tento soubor nepodporuje externí úpravy.
.nástupiště
Soubor platformy Fabric, který obsahuje vlastnosti nezbytné pro vytvoření a údržbu propojení mezi položkami Infrastruktury a Gitem.
Další informace najdete v tématu Integrace Gitu automaticky generovaných systémových souborů.
Formát TMDL
S cílem zajistit lepší správu zdrojového kódu a prostředí pro spoluvytváření můžete ukládat soubory projektu Power BI (PBIP) pomocí jazyka TMDL (Tabular Model Definition Language) jako formátu sémantického modelu.
Na rozdíl od jazyka TMSL (Tabular Model Scripting Language) byl TMDL od základů navržen tak, aby byl uživatelsky přívětivý, což usnadňuje nejen čitelnost , ale také snadné úpravy v libovolném textovém editoru. To představuje významné vylepšení správy zdrojového kódu a prostředí pro spolupráci při vývoji.
Místo velkého souboru JSON, jako je například jazyk TMSL (Tabular Model Scripting Language), má TMDL strukturu složek se samostatnými soubory pro každou tabulku, perspektivu, roli a jazykovou verzi. To usnadňuje práci s ostatními a pochopení sémantické struktury modelu pouhým pohledem na složku a soubory. V konečném důsledku to vede ke skvělému prostředí správy zdrojového kódu a spoluvytváření při řešení konfliktů git diff a slučování.
Další informace o TMDL najdete tady.
Povolení funkce náhledu formátu TMDL
Ukládání jako projekt Power BI pomocí TMDL je aktuálně ve verzi Preview. Než ho začnete používat, musíte ho nejdřív povolit ve funkcích Preview:
Přejděte na Možnosti souborů > a nastavení > Možnosti > náhledu funkcí a zaškrtněte políčko vedle sémantického modelu Store pomocí formátu TMDL.
Uložení jako projektu pomocí TMDL
Pokud je funkce TMDL Preview povolená, při uložení projektu se sémantický model uloží jako složka TMDL s názvem \definition uvnitř složky sémantického modelu:
Přečtěte si další informace o struktuře složek TMDL.
Převod existujícího PBIP na TMDL
Pokud už máte PBIP používající TMSL jako formát sémantického modelu, můžete ho převést na TMDL následujícím způsobem:
Otevřete PBIP v Power BI Desktopu.
Ujistěte se, že je povolená funkce Preview.
Uložte projekt. Zobrazí se výzva s žádostí o upgrade na TMDL.
Vyberte Upgrade.
Důležité
Po upgradu na TMDL se nemůžete vrátit zpět na TMSL. Pokud si myslíte, že se možná budete chtít vrátit zpátky k TMSL, uložte nejdřív kopii souborů PBIP.
Existující soubor TMSL (Tabular Model Scripting Language) (model.bim) se nahradí složkou \definition obsahující reprezentaci TMDL sémantického modelu.
Pokud vyberete možnost Zachovat aktuální formát, Desktop se znovu nezobrazí výzva k upgradu.
Provedení externích změn souborů TMDL
Pokud chcete lépe číst a upravovat soubory TMDL, nainstalujte rozšíření TMDL – Visual Studio Marketplace pro Microsoft VS Code.
Otevřete složku PBIP pomocí nástroje VS Code a přejděte do sémantické složky definice modelu.
Power BI Desktop neví o změnách souborů projektu provedených jinými nástroji. Pokud tedy provedete nějaké změny při otevírání souborů mimo Power BI Desktop, musíte tyto změny v Power BI Desktopu restartovat.
Informace o podporovaných operacích zápisu mimo Power BI Desktop najdete tady.
Chyby TMDL
Pokud jsou v souborech TMDL provedeny neplatné úpravy, Power BI Desktop vyvolá při otevření chybu s umístěním chyby:
Aspekty a omezení TMDL
Ve verzi Public Preview bude integrace Gitu prostředků infrastruktury ve výchozím nastavení exportovat sémantický model pomocí TMSL. Pokud se ale sémantický model naimportuje do prostředků infrastruktury pomocí integrace Infrastruktury Gitu s formátem TMDL, integrace Gitu fabric použije formát TMDL k exportu definice sémantického modelu do Gitu, pokud se ve službě změní sémantický model.
Důležité
Pokud importujete sémantický model pomocí jakékoli jiné metody importu, jako je publikování v Power BI Desktopu, integrace Gitu s prostředky infrastruktury se přepne zpět na výchozí formát TMSL.