Práca so zobrazením TMDL v aplikácii Power BI Desktop (ukážka)

Článok
01/15/2025

zobrazenia TMDL umožňuje skriptovať, upravovať a používať zmeny v objektoch sémantického modelu s moderným editorom kódu pomocou jazyka TMDL (Tabular Model Definition Language) v aplikácii Power BI Desktop, čím zlepšuje efektivitu vývoja a poskytuje úplnú viditeľnosť a kontrolu nad metaúdajmi sémantického modelu.

zobrazenie TMDL ponúka alternatívne prostredie pre sémantické modelovanie pomocou kódu namiesto grafického používateľského rozhrania, ako je zobrazenie modelu.

Zobrazenie TMDL ponúka nasledujúce výhody:

vylepšená efektivita vývoja s editorom formátu RTF, ktorý zahŕňa vyhľadávanie a nahradenie, klávesové skratky, viacriadkové úpravy a ďalšie funkcie.
Zvýšiť opätovnú využiteľnosť jednoduchým skriptovaním, zdieľaním a opätovným využívaním skriptov TMDL medzi vývojármi sémantických modelov. Môžete napríklad použiť centralizovanú lokalitu SharePoint na jednoduché zdieľanie opätovne použiteľných sémantických objektov modelu, ako sú napríklad tabuľky kalendára alebo skupiny výpočtov časovej inteligencie.
Získať väčšiu kontrolu a priehľadnosť, ktorá zobrazuje všetky objekty a vlastnosti sémantického modelu a umožňuje zmeny položiek, ktoré nie sú k dispozícii v používateľskom rozhraní aplikácie Power BI Desktop, ako napríklad IsAvailableInMDX alebo DetailRowsDefinition.

Povolenie funkcie vo verzii Preview

Ak chcete použiť zobrazenia TMDL, musíte povoliť funkciu ukážky. V aplikácii Power BI Desktop vyberte položky Súbor Možnosti a nastavenia Možnosti ukážky funkcií a začiarknite políčko vedľa položky TMDL View.

Skriptovať do TMDL

V aplikácii Power BI Desktop vyberte ikonu zobrazenia TMDL, ktorá sa nachádza pozdĺž ľavej strany okna, ako je to znázornené na nasledujúcom obrázku.

Snímka obrazovky znázorňujúca zobrazenie jazyka T-M-D-L jazyka tabuľkového modelu.

Keď sa otvorí zobrazenie TMDL, editor kódu je spočiatku prázdny. Ľubovoľný objekt sémantického modelu, ako je napríklad tabuľka, mierka alebo stĺpec, môžete skriptovať tak, že vyberiete objekty na table údaje a presuniete ich do editora kódu:

Snímka obrazovky znázorňujúca presunutia objektu sémantického modelu na plátno zobrazenia T-M-D-L.

Pri použití zobrazenia TMDL a presunutí objektu z tably Údaje služba Power BI skriptuje celé metaúdaje objektu na aktuálnu kartu ako TMDL, alebo otvorí novú kartu, ak aktuálna karta nie je prázdna, ako createOrReplace skript TMDL vybratých objektov, ako je to znázornené na nasledujúcom obrázku:

Snímka obrazovky s metaúdajmi T-M-D-L, ktoré sa vytvárajú automaticky.

Prípadne môžete kliknúť pravým tlačidlom myši na objekt v zobrazení Údaje a vybrať položky Skript TMDL na novú kartu alebo do Schránky, ako je znázornené na nasledujúcom obrázku:

Snímka obrazovky zobrazujúca kliknutie pravým tlačidlom myši na objekt v zobrazení údajov, aby služba Power BI vytvorila kód metaúdajov T-M-D-L.

Tip

Viacnásobný výber je podporovaný stlačením klávesu CTRL a až potom skriptovaním objektov do editora kódu zobrazenia TMDL.

Editor kódu

Po skriptovaní objektu sémantického modelu alebo prilepení skriptu TMDL do editora kódu môžete použiť komplexné funkcie prostredia kódu, ktoré ponúka editor kódu zobrazenia TMDL. Funkcie prostredia kódu umožňujú buď preskúmať metaúdaje modelu, alebo vykonať úpravy, ktoré je možné neskôr použiť v sémantickom modeli.

Sémantické zvýraznenie

Sémantické zvýraznenie je zabudované v editore kódu, čo zlepšuje čitateľnosť použitím rôznych farieb na časti kódu na základe významu. Takéto farebné kódovanie uľahčuje pochopenie štruktúry a funkčnosti vášho kódu TMDL, ako je znázornené na nasledujúcom obrázku.

Snímka obrazovky farebného kódovania a sémantického zvýraznenia pre kód metaúdajov T-M-D-L.

Môžete tiež rozbaliť alebo zbaliť časti skriptu TMDL, ako je to znázornené na nasledujúcom obrázku:

Snímka obrazovky zbalenia sekcií kódu v editore kódu.

Automatické dokončovanie

Automatické dokončovanie je zabudované v editore kódu a ponúka inteligentné návrhy počas písania. Automatické dokončovanie môže urýchliť pracovný postup, znížiť pravdepodobnosť chýb a pomôcť vám pochopiť možnosti kódu tým, že dynamicky navrhuje možné hodnoty alebo vlastnosti tak, že vezme do úvahy pozíciu kurzora.

Snímka obrazovky automatického dokončovania v editore kódu.

Funkciu automatického dokončovania môžete spustiť aj na ľubovoľnom mieste stlačením stlačením kombinácie klávesov Ctrl + medzerník.

Diagnostika chýb

Vstavaná diagnostika chýb editora kódu vám pomôže identifikovať a opraviť problémy zvýraznením chýb jazyka TMDL v editore kódu s podrobnými správami, ktoré poskytujú pokyny na ich riešenie. Okrem toho je súhrn chýb k dispozícii na table Problems, čo umožňuje jednoduchú navigáciu do umiestnenia chyby v editore kódu, ako je to znázornené na nasledujúcom obrázku.

Snímka obrazovky diagnostiky chýb v editore kódu.

Použitie zmien v sémantickom modeli

Keď budete pripravení, môžete výberom tlačidla Použiť spustiť skript TMDL v sémantickom modeli a použiť zmeny kódu TMDL.

Snímka obrazovky znázorňujúca použitie skriptu pomocou tlačidla Použiť v editore kódu.

Po úspešnom dokončení sa zobrazí oznámenie a zmena modelovania sa použije na sémantický model.

Snímka obrazovky znázorňujúca úspech v editore kódu označujúca úspešné použitie zmien.

V prípade zlyhania sa zobrazí oznámenie o chybe, ktoré ukáže, že zmeny modelovania sa nepoužili v sémantickom modeli. Ďalšie informácie o chybe zobrazíte tak, že v oznámení vyberiete prepojenie Zobraziť podrobnosti, ktoré následne rozbalí tablu Výstup a zobrazí podrobnosti o chybe.

Snímka obrazovky znázorňujúca banner s zlyhaním v editore kódu označujúci, že zmeny neboli úspešné.

Nota

Zobrazenie TMDL upravuje iba metaúdaje sémantického modelu bez obnovenia údajov alebo vplyvu na zostavu. Ak zmeny vyžadujú obnovenie údajov, napríklad zmenu výrazu doplnku PowerQuery alebo výraz vypočítaného stĺpca, musíte tabuľku alebo model obnoviť manuálne, aby sa zmeny prejavili. Okrem toho môže premenovanie poľa v zobrazení TMDL narušiť vizuály v rámci zostavy, ktorá používa toto pole.

Karty skriptu TMDL

V zobrazení TMDL môžete mať viacero kariet skriptu naraz, z ktorých každú možno premenovať alebo odstrániť.

Snímka obrazovky viacerých kariet v zobrazení T-M-D-L.

Obsah zobrazenia TMDL karty sa uložia do súboru zostavy, keď uložíte zostavu aplikácie Power BI Desktop, takže môžete pokračovať tam, kde ste prestali pri ďalšom otvorení súboru zostavy aplikácie Power BI Desktop. Pri ukladaní do Power BI Project (PBIP), sa každá karta skriptu uloží ako súbor .tmdl v priečinku \TMDLScripts, ako je znázornené na nasledujúcom obrázku.

Snímka obrazovky so štruktúrou súboru pre ukladanie kariet v súbore aplikácie Power BI Desktop.

Tip

Skripty TMDL môžete otvárať a upravovať v programe Visual Studio Code a po reštartovaní aplikácie Power BI Desktop sa budú správne znova načítavať.

Na tablách problémy a Výstup sa zobrazujú chyby a správy špecifické pre kartu skriptu, ktorá je aktuálne vybratá a zobrazená. Prepnutím na inú kartu TMDL scrip sa obnovia obe tieto tably s informáciami špecifickými pre vybratú a aktuálne zobrazenú kartu.

Môžete vybrať tlačidlo Vymazať, čím vyplníte správy tably Output.

Snímka obrazovky znázorňujúca tlačidlo Vymazať, ktoré sa používa na prázdne správy výstupnej tably.

Správy sa uchovávajú len pre každú reláciu aplikácie Power BI Desktop, takže pri reštartovaní aplikácie Power BI Desktop sa vymažú všetky výstupné správy pre všetky karty skriptov.

Zobrazenie TMDL a projekt Power BI

Keď si prácu uložíte ako projekt služby Power BI (PBIP), získate prístup k metaúdajom definície sémantického modelu ako súborom TMDL, čím získate užitočnú kontrolu nad zdrojom a skúsenosti s vaším vývojom a zároveň môžete meniť v sémantickom modeli mimo aplikácie Power BI Desktop. Ak však upravíte súbory TMDL v rámci súboru PBIP, musíte reštartovať aplikáciu Power BI Desktop, aby ste tieto zmeny znova načítali. Naopak zobrazenie TMDL sleduje skriptovací duševný model, ktorý vám umožňuje efektívne použiť zmeny priamo na sémantický model, ktorý sa upravuje v aplikácii Power BI Desktop pomocou TMDL, bez ohľadu na to, či je formát súboru PBIX alebo PBIP.

Obe prostredia môžete bez problémov integrovať. Môžete napríklad aktualizovať definíciu TMDL v PBIP na rýchle zmeny bez toho, aby ste spustili aplikáciu Power BI Desktop, a využiť zobrazenie TMDL, keď je aplikácia Power BI Desktop už otvorená na efektívne implementáciu série zmien v sémantickom modeli pomocou TMDL. Oba prístupy ponúkajú bohatú a konzistentnú skúsenosť s kódovaním TMDL.

Bežné prípady použitia pre zobrazenie TMDL

Scenár: musím opätovne použiť a zdieľať sémantický model tabuľky s jeho úplnou definíciou vrátane stĺpcov, výrazu Power Query a zoradenia podľa konfigurácie a ďalších v inom sémantickom modeli.

Solution: Otvoriť sémantický model s tabuľkou, skriptujte ho pomocou zobrazenia TMDL. Skopírujte skript do druhého okna aplikácie Power BI Desktop, otvorte kartu zobrazenia TMDL a použite skript.

Scenár:, že všetky tabuľky pomenujem pomocou predpon "dim_" alebo "fact_". Tieto predpony by som chcel odstrániť bez manuálnej aktualizácie každej z viac ako 100 tabuliek.

Solution: Otvoriť zobrazenie TMDL, skriptovať sémantický model, vyhľadať predponu (regulárne výrazy sa podporujú) a nahradiť ju prázdnym textom.

scenár: v sémantickom modeli musím vytvoriť perspektívu, aby som mohol používať funkciu prispôsobených vizuálov. Nemôžem ho však vytvoriť ani upraviť pomocou grafického rozhrania aplikácie Power BI Desktop.

Riešenie: Otvoriť zobrazenie TMDL, vytvorte novú prázdnu kartu (alebo použite skript z existujúcej perspektívy) a potom vytvorte alebo upravte perspektívu pomocou TMDL. Táto metóda sa vzťahuje aj na iné metaúdaje sémantického modelu, ktoré nemajú grafické rozhranie, ako sú preklady, výrazy riadkov s podrobnosťami a ďalšie.

createOrReplace
      perspective SalesView
        perspectiveTable Sales
            perspectiveMeasure 'Sales Amount'
            perspectiveMeasure 'Sales Qty'
            perspectiveColumn Quantity
            perspectiveColumn 'Amount'

Scenár: musím upraviť výraz Power Query v tabuľke bez spustenia obnovenia.

Riešenie: skriptovať tabuľku, upraviť výraz Power Query a použiť zmeny. Zobrazenie TMDL nevyžaduje obnovenie údajov.

scenár: musím prepnúť režim úložiska tabuľky z režimu DirectQuery na režim Import a naopak.

riešenie: skriptovať tabuľku, aktualizovať režim oblasti a použiť zmeny.

Scenár: musím zálohovať definíciu sémantického modelu pred vykonaním významných zmien a v prípade potreby jednoducho vrátiť predchádzajúcu definíciu.

riešenie: skriptovať sémantický model alebo konkrétne časti, ktoré chcete zálohovať, vykonať zmeny v iných zobrazeniach a v prípade potreby sa vrátiť do zobrazenia TMDL, čím obnovíte predchádzajúce metaúdaje spustením uloženého skriptu.

Dôležité informácie a obmedzenia

Zobrazenie TMDL je momentálne vo verzii Preview, preto majte na pamäti nasledujúce obmedzenia:

Niektoré zmeny modelovania nie sú podporované. Počas používania verzie Preview prejde každá Použiť rovnakým overeniam, ku ktorým dôjde pri otváraní projektu Power BI (PBIP). Zoznam podporovaných zmien nájdete v článku Tvorba modelu (Stĺpec Zmena súboru). Vykonávanie nepodporovaných zmien môže mať za následok neočakávané správanie.
Paleta príkazov zobrazuje niektoré príkazy, ktoré momentálne nie sú podporované.
Nastavenie počiatočnej integrácie Git z pracovný priestor nebude obsahovať skripty zobrazenia TMDL uložené v publikovanom sémantickom modeli. Ďalšie informácie nájdete v článku Integrácia Git do služby Fabric.
Skupiny prieskumníka modelov skriptov, ako sú napríklad Mierky, Stĺpce, atď.
Zobrazenie TMDL nie je k dispozícii pri úprave sémantických modelov Direct Lake.

Nasledujúce články popisujú viac o protokole TMDL a jeho používaní.

Zdieľať cez

Práca so zobrazením TMDL v aplikácii Power BI Desktop (ukážka)

Povolenie funkcie vo verzii Preview

Skriptovať do TMDL