Projekty aplikácie Power BI Desktop (PREVIEW)
Dôležité
Projekty aplikácie Power BI Desktop sú v súčasnosti vo verzii Preview.
Prepitné
Pokyny na plánovanie vývoja v službe Power BI nájdete v téme Plánovanie implementácie služby Power BI.
Power BI Desktop prináša nový spôsob vytvorenia, spolupráce a ukladania projektov. Keď si prácu uložíte ako projekt Power BI (PBIP), definície položiek zostavy a sémantického modelu sa uložia ako jednotlivé súbory s obyčajným textom v jednoduchej intuitívnej štruktúre priečinkov.
Ukladanie práce ako projektu má nasledujúce výhody:
Podpora textového editora – súbory definície položiek sú textové súbory formátované formátom JSON obsahujúce sémantický model a metaúdaje zostavy. Tieto súbory sú verejne zdokumentované a čitateľné pre ľudí. Zatiaľ čo projektové súbory podporujú jednoduché nástroje na úpravu textu, ako je poznámkový blok, je lepšie použiť editor kódu, ako je napríklad Visual Studio Code (VS Code), ktorý poskytuje bohaté možnosti úprav vrátane integrácie intellisense, overenia a Git.
Generovanie programových položiek a úprava definícií položiek – môžete vytvárať skripty pomocou obľúbeného a ľahko použiteľného jazyka na skriptovanie tabuľkového modelu (TMSL) alebo môžete vytvárať vlastné aplikácie na vykonávanie zmien definícií položiek. Aplikácie môžu byť založené na verejnej dokumentácii schém definície položiek a/alebo klientskych knižníc.
Ovládací prvok zdroja – sémantický model služby Power BI a definície položiek zostavy môžu byť uložené v systéme správy zdrojov, ako je napríklad Git. S funkciou Git môžete sledovať históriu verzií, porovnávať revízie (diff) a vrátiť sa k predchádzajúcim verziám. Zdrojový ovládací prvok môže tiež odblokovať spoluprácu pri používaní aplikácie Power BI Desktop pomocou známych mechanizmov spolupráce na riešenie konfliktov (zlučovanie) a kontrolu zmien (žiadostí o prijatie zmien). Ďalšie informácie nájdete v téme Ovládanie verzií v Git.
Spojitá integrácia a nepretržité doručovanie (CI/CD) – môžete používať systémy, v ktorých vývojári vo vašej organizácii odošlú navrhovanú zmenu do systému CI/CD. Systém potom pred použitím zmeny na produkčnom systéme overí zmenu sériou kvalitných brán . Tieto brány kvality môžu zahŕňať recenzie kódov od iných vývojárov, automatizované testovanie a automatizovanú zostavu na overenie integrity zmien. Systémy CI/CD sú zvyčajne postavené na existujúcich systémoch správy zdrojov. Ďalšie informácie nájdete v téme DevOps – Spojitá integrácia a DevOps – priebežné doručovanie.
Povolenie funkcií predbežnej verzie
Ukladanie vo forme projektu Power BI v aplikácii Power BI Desktop je momentálne v režime ukážky a musíte ho povoliť vo funkciách verzie Preview.
Prejdite na položky Súbor > Možnosti a nastavenia > Funkcie > ukážky a začiarknite políčko vedľa možnosti uloženia projektu Power BI (.pbip).
Uložiť ako projekt
Ak pracujete na novom projekte alebo ste otvorili existujúci súbor aplikácie Power BI Desktop (pbix), môžete svoju prácu uložiť ako súbor projektu Power BI (pbip):
Keď uložíte ako projekt, Power BI Desktop uloží položky zostavy a sémantické položky modelu ako priečinky, pričom každý z nich obsahuje textové súbory definujúce položku:
Po uložení ako projektu si môžete pozrieť, kedy pracujete na projekte, a to tak, že sa pozriete na záhlavie okna:
Ak vyberiete v záhlaví okna rozbaľovaciu ponuku, ktorá je špecifická pre projekt Power BI. Táto rozbaľovacia ponuka umožňuje vyhľadať súbory projektu a nastavenia zobrazovaného názvu pre zostavu a sémantický model. Priečinok môžete otvoriť aj v prieskumníkovi súborov kliknutím na cesty.
Pozrime sa bližšie na to, čo vidíte v koreňovom priečinku projektu:
<názov> projektu. SémanticModel
Kolekcia súborov a priečinkov, ktoré predstavujú sémantický model služby Power BI. Ďalšie informácie o súboroch a podpriečinkoch a súboroch nájdete v téme Priečinok Sémantický model projektu.
<názov> projektu. Správa
Kolekcia súborov a priečinkov, ktoré predstavujú zostavu Power BI. Ďalšie informácie o súboroch a podpriečinkoch a súboroch nájdete v téme Priečinok zostavy Project.
.gitIgnore
Určuje zámerne nesledované súbory, ktoré by mal Git ignorovať pre súbory projektu Power BI, ako je napríklad cache.abf a localSettings.json.
Power BI Desktop vytvorí súbor .gitignore iba vtedy, ak neexistuje vo vybratom priečinku ukladania alebo nadradenom odkladacom priestore Git.
Predvolený obsah .gitignore pri ukladaní ako PBIP:
**/.pbi/localSettings.json
**/.pbi/cache.abf
<názov> projektu.pbip
Súbor PBIP obsahuje ukazovateľ na priečinok zostavy. Otvorením súboru PBIP sa otvorí cieľová zostava a model na vytváranie obsahu.
Ďalšie informácie nájdete v dokumente schémy pbip.
Otvorenie projektu Power BI
Aplikáciu Power BI Desktop môžete otvoriť z priečinka Power BI Project buď otvorením súboru pbip alebo súboru pbir v priečinku zostavy. Obe možnosti otvoria zostavu na úpravu a sémantický model, ak existuje relatívny odkaz na sémantický model.
Do rovnakého priečinka môžete uložiť viacero zostáv a sémantických modelov. Nie je potrebné mať samostatný súbor pbip pre každú zostavu, pretože každú zostavu môžete otvoriť priamo z .pbir v priečinku zostavy.
├── project
│ ├── AdventureWorks-Sales.Report
│ │ └── definition.pbir
│ ├── AdventureWorks-Stocks.Report
│ │ └── definition.pbir
│ ├── AdventureWorks.SemanticModel
| | └── *.*
│ .gitignore
└── AdventureWorks.pbip
Zmeny mimo aplikácie Power BI Desktop
Ak ste sa uložili ako projekt, nie ste nútení písať zmeny v sémantickom modele a definíciách zostáv iba v aplikácii Power BI Desktop. Môžete použiť aj iné nástroje, ako napríklad VS Code, open-source nástroje komunity, ako napríklad Tabular Editor, alebo dokonca Poznámkový blok. Nie každý súbor alebo zmena však podporuje úpravy externými nástrojmi typu open-source.
Zmeny súborov alebo vlastností mimo aplikácie Power BI Desktop môžu spôsobiť neočakávané chyby alebo dokonca zabrániť otváraniu aplikácie Power BI Desktop. V týchto prípadoch musíte vyriešiť problémy v súboroch a až potom sa pokúsiť otvoriť projekt znova v aplikácii Power BI Desktop.
Ak je to možné, Power BI Desktop indikuje súbor a umiestnenie chyby:
Podrobnosti schémy pre nasledujúce súbory nie sú zdokumentované. Počas používania verzie Preview sa zmeny v týchto súboroch mimo aplikácie Power BI Desktop nepodporujú:
- Správa\
- SemanticModel\
Vytváranie modelov
Zmeny v definícii sémantického modelu môžete vykonávať pomocou externých nástrojov dvoma spôsobmi:
- Pripojením k inštancii služby Analysis Service (AS) aplikácie Power BI Desktop s externými nástrojmi.
- Úpravou metaúdajov JSON v súbore model.bim pomocou nástroja VS Code alebo iného externého nástroja.
Nie každý objekt modelu podporuje operácie zapisovaia. Použitie zmien mimo týchto podporovaných môže spôsobiť neočakávané výsledky.
Objekty, ktoré podporujú operácie zapisovaia:
| Object | Pripojenie k inštancii AS | Zmena súboru |
|---|---|---|
| Tabuľky | Nie | Áno |
| Stĺpce | Áno 1, 2 | Áno |
| vypočítané tabuľky, | Áno | Áno |
| Vypočítané stĺpce | Áno | Áno |
| Hierarchie | Áno | Áno |
| Vzťahy | Áno | Áno |
| Miery | Áno | Áno |
| Kľúčové ukazovatele výkonu modelu | Áno | Áno |
| Skupiny výpočtov | Áno | Áno |
| Perspektívy | Áno | Áno |
| Preklady | Áno | Áno |
| Zabezpečenie na úrovni riadkov | Áno | Áno |
| Zabezpečenie na úrovni objektu (Object Level Security, OLS) | Áno | Áno |
| Poznámky | Áno | Áno |
| Výrazy jazyka M | No | Áno 3, 4 |
Majte na pamäti:
Všetky zmeny na otváranie súborov vykonaných mimo aplikácie Power BI Desktop vyžadujú reštartovanie, aby sa tieto zmeny zobrazili v aplikácii Power BI Desktop. Aplikácia Power BI Desktop nemá informácie o zmenách súborov projektov, ktoré vykonali iné nástroje.
Power BI Desktop nepodporuje tabuľky s viacerými oblasťami. Pre každú tabuľku je podporovaná len jedna oblasť. Vytvorenie tabuliek s prázdnymi oblasťami alebo viacerými oblasťami má za následok chybu pri otváraní zostavy.
Tabuľky automatického dátumu vytvorené aplikáciou Power BI Desktop by sa nemali meniť pomocou externých nástrojov.
Pri zmene modelu, ktorý používa priamy dotaz na pripojenie sémantického modelu služby Power BI alebo modelu služby Analysis Services, musíte aktualizovať kolekciu ChangedProperties a PBI_RemovedChildren pre zmenený objekt tak, aby obsahoval akékoľvek upravené alebo odstránené vlastnosti. Ak sa neaktualizujú nastavenia ChangedProperties a/alebo PBI_RemovedChildren, Power BI Desktop môže pri nasledujúcej úprave dotazu alebo obnovení modelu v aplikácii Power BI Desktop prepísať všetky zmeny.
1 – Zmena typu údajov stĺpca je podporovaná. Pri pripájaní k inštancii AS však premenovanie stĺpcov nie je podporované.
2 – Ak má sémantický model povolenú funkciu Automatický dátum a čas a mimo aplikácie Power BI Desktop vytvoríte nový stĺpec datetime, lokálna tabuľka dátumov sa nevygeneruje automaticky.
3 – Typ zdroja oblasti sa musí vypočítať, M, Entita alebo Výpočtová skupina. Režim oblasti musí byť Import, DirectQuery alebo Duálny.
4 – Všetky úpravy výrazov mimo aplikácie Power BI Desktop v projekte s unappliedChanges.json sa po použití týchto zmien stratia.
Úprava výrazov dotazu tabuľky mimo aplikácie Power BI Desktop spôsobí, že pri reštartovaní aplikácie Power BI Desktop sa údaje tabuľky odstránia.
Schémy súborov JSON
Väčšina projektových súborov obsahuje metaúdaje vo formáte JSON. Zodpovedajúce schémy JSON je možné použiť na overenie a dokumentáciu.
So schémami JSON môžete:
- Získajte informácie o konfigurovateľných vlastnostiach.
- Použite overenie vloženého JSON poskytnuté editorom kódu.
- Vylepšite vytváranie pomocou zvýraznenia syntaxe, popisov a automatického dokončovania.
- Používanie externých nástrojov s vedomím podporovaných vlastností v rámci metaúdajov projektu.
Použite nástroj VS Code na priradenie schém JSON k vytvoreným súborom. Schémy JSON pre projektové súbory sú k dispozícii v odkladacom priestore Git pre vzorové údaje aplikácie Power BI Desktop.
Dôležité informácie a obmedzenia
- Aplikácia Power BI Desktop nevie o zmenách vykonaných v iných nástrojoch alebo aplikáciách. Zmeny vykonané pomocou externých nástrojov vyžadujú reštartovanie aplikácie Power BI Desktop pred tým, ako sa tieto zmeny zobrazia.
- Označenia citlivosti nie sú podporované s projektmi služby Power BI.
- Zobrazenie diagramu sa pri úprave modelov v službe ignoruje.
- Pri ukladaní ako projektu Power BI je maximálna dĺžka cesty k súborom projektu 260 znakov.
- V aplikácii Power BI Desktop nie je možné uložiť ako PBIP priamo do OneDrivu a SharePointu.
- Keď upravujete súbory PBIP mimo aplikácie Power BI Desktop, mali by sa uložiť pomocou utf-8 bez kódovania BOM.
- Jazyková schéma zostáv nie je podporovaná s projektmi Power BI.
- Aplikácia Power BI Desktop používa crlf ako koniec riadka. Aby ste sa vyhli problémom vo vašich rozdieloch, nakonfigurujte Git tak, aby spracúvala koncovky riadkov zapnutím funkcie automatické krížové spustenie.
- Projekty Power BI nie sú v súčasnosti podporované vo verzii aplikácie Microsoft Power BI Desktop optimalizovanej pre Power BI Report Server.
- Zostavy dynamického pripojenia uložené ako PBIP vyžadujú, aby sa povolil koncový bod XMLA.
Najčastejšie otázky
Otázka: Pri pohľade na sémantický model a definície priečinka položiek zostavy je podľa potreby označených len niekoľko súborov. Čo sa stane, ak ich odstránim?
Odpoveď: Aplikácia Power BI Desktop ich automaticky vytvorí pri ukladaní ako projekt (PBIP).
Otázka: Vie aplikácia Power BI Desktop o zmenách, ktoré vykonám v súboroch projektu Power BI z externého nástroja alebo aplikácie?
Odpoveď: Nie. Každá zmena, ktorá sa vykoná v súboroch, vyžaduje reštartovanie aplikácie Power BI Desktop, aby sa tieto zmeny prejavili.
Otázka: Ak skonvertujem súbor PBIX na PBIP, môžem ho previesť späť na súbor PBIX?
Odpoveď: Áno. Súbor PBIX môžete uložiť ako PBIP alebo súbor PBIP uložiť ako súbor PBIX.
Otázka: Môžem previesť súbor PBIX na PBIP a naopak pomocou programovania?
Odpoveď: Nie. Súbor PBIX môžete previesť iba na PBIP a naopak pomocou možnosti>Súbor Uložiť ako v aplikácii Power BI Desktop.
Otázka: Môžem nasadiť projekt aplikácie Power BI Desktop do služieb Azure Analysis Services (AAS) alebo SQL Server Analysis Services (SSAS)?
Odpoveď: Nie. Definície zostavy projektu aplikácie Power BI Desktop nie sú podporované v AAS a SSAS. Definície modelu používajú rozšírené metaúdaje jedinečné pre službu Power BI. V prípade projektov AAS a SSAS použite Microsoft Visual Studio na vytváranie modelov, integráciu Git a Azure DevOps.
Otázka: Prečo sa pri pripájaní pracovného priestoru služby Fabric k systému Git nezobrazuje súbor *.pbip? Ako upravím svoj model zostavy a sémantického modelu v aplikácii Power BI Desktop?
Odpoveď: Súbor PBIP je voliteľný a jednoducho slúži ako odkaz na priečinok zostavy. Zostavu aj sémantický model na úpravu v aplikácii Power BI Desktop môžete otvoriť otvorením súboru definition.pbir, ktorý sa nachádza v priečinku zostavy.