Složka sémantického modelu projektu Power BI Desktopu

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:

• .pbi\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• Složka DAXQueries\
• složka TMDLScripts\
• definition\ folder³
• model.bim²
• diagramLayout.json
• .platforma
• definition.pbism¹

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.jszapnuto

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.jszapnuto

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 Analysis Services Backup (ABF) obsahující místně uloženou kopii modelu a dat v mezipaměti, když byly naposledy upraveny. 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 úplnou definicí, ale bez dat. Pokud cache.abf existuje, Power BI Desktop načte data a přepíše definici modelu pomocí metadat sémantického modelu v rámci projektu.

.pbi\unappliedChanges.jszapnuto

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 Použít změny, Power BI Desktop přepíše dotazy v metadatech sémantického modelu dotazy z unappliedChanges.json. Pokud jste upravili dotazy 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.

definice.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.

definice\ složka

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 spojeného se sestavou. Tento soubor nemůžete externě upravovat.

.platforma

Soubor platformy Fabric, který obsahuje vlastnosti nezbytné pro vytvoření a údržbu propojení mezi položkami Fabric a Gitem.

Další informace najdete v tématu Integrace Gitu automaticky generovaných systémových souborů.

Složka DAXQueries\

Obsahuje soubor pro každý panel zobrazení dotazu DAX uložený [Tab name].dax jako soubor DAX.

.pbi\daxQueries.json

Obsahuje nastavení editoru zobrazení dotazů DAX, jako je výchozí panel nebo pořadí panelů.

TMDLScripts\ složka

Obsahuje soubor pro každou záložku skriptu zobrazení TMDL uložený jako soubor TMDL.

.pbi\tmdlscripts.json

Obsahuje nastavení editoru zobrazení TMDL , jako je výchozítab nebo pořadí ovládacích prvků.

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.

Provedení externích změn souborů TMDL

Soubory TMDL můžete upravovat v Visual Studio Code nebo jiném externím nástroji, zatímco projekt zůstane otevřený v Power BI Desktopu. Pro lepší prostředí pro úpravy TMDL nainstalujte rozšíření TMDL pro Visual Studio Code.

Před externí úpravou souborů uložte všechny změny v Power BI Desktopu. Otevřete složku PBIP ve VS Code, přejděte do složky sémantického modelu definition a uložte změny TMDL. Power BI Desktop zjistí uložené změny a zobrazí banner Použít externí změny. Výběrem možnosti Použít externí změny znovu načtěte sémantický model bez zavření a opětovného otevření projektu.

Pokud Power BI Desktop obsahuje neuložené změny, upozorní vás, že použití externích změn je přepíše. Kompletní pracovní postup a omezení najdete v tématu Úprava souborů PBIP mimo Power BI Desktop.

Podporované operace zápisu mimo Power BI Desktop najdete v tématu Vytváření modelů.

Chyby TMDL

Pokud je úprava TMDL neplatná, Power BI Desktop zobrazí chybu při použití externích změn nebo otevření projektu. Tato chyba identifikuje umístění, které je nutné opravit, než Power BI Desktop může načíst aktualizovaný sémantický model:

Související obsah

• Složka sestavy projektu Power BI Desktop
• Projekty Power BI Desktopu
• Jazyk TMSL (Tabular Model Scripting Language)