Zdieľať cez

Projekty aplikácie Power BI Desktop (PREVIEW)

Important

Projekty aplikácie Power BI Desktop sú momentálne vo verzii Preview.

Tip

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 PBIP sú formátované textové súbory 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.

  • Priehľadnosť štruktúry priečinkov – samostatné priečinky pre sémantický model a zostavu, ktoré umožňujú výkonné, ale jednoduché úlohy, ako je kopírovanie tabuliek sémantických modelov medzi projektmi alebo opätovné použiť strany zostavy. Výbornou voľbou na vytváranie a opätovné používanie šablón pre vývoj.

  • Pripravený zdrojový ovládací prvok – môžete otvárať textové súbory navrhnuté na bezproblémovú integráciu so systémom Git, povoľovanie histórie verzií a tímovú spoluprácu. Ďalšie informácie nájdete v téme Ovládanie verzií v Git.

  • Podpora spojitej integrácie a nepretržitého doručovania (CI/CD) – použite postupy CI/CD na základe existujúcich zdrojových kontrolných systémov pomocou súborov PBIP, zahŕňajúcej brány kvality a automatizáciu nasadenia do produkčných prostredí. Ďalšie informácie o CI/CD v službe Fabric nájdete v téme Pracovné postupy ci/CD služby Fabric.

  • generovanie programových položiek a úprava definícií položiek – môžete programovo generovať a upravovať textové súbory definície položiek, pričom povolíte dávkové operácie, ako je napríklad aktualizácia všetkých vizuálov na stránkach zostavy alebo pridanie množiny mierok do každej tabuľky. V prípade sémantických modelov môžete použiť tabuľkového objektového modelu (TOM) klientskej knižnice na deserializáciu metaúdajov sémantického modelu, vykonanie programových úprav a serializáciu späť do súborov.

Povolenie funkcií predbežnej verzie

Ukladanie ako projekt Power BI v aplikácii Power BI Desktop je momentálne vo verzii Preview a musíte ho povoliť vo funkciách ukážky.

Prejdite na >> ukážky a začiarknite políčko vedľa > 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):

Chyť obrazovky zobrazujúca uloženie súboru ako projekt Power BI

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:

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

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 v prípade, že ešte neexistuje vo vybratom priečinku na uloženie alebo v 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

Power BI Desktop môžete otvoriť z priečinka Power BI Project 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. Samostatný súbor pbip pre každú zostavu sa nevyžaduje, 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/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

Po uložení ako projektu si môžete pozrieť, kedy pracujete na projekte, a to tak, že sa pozriete na záhlavie okna:

Uchopenie obrazovky zobrazujúce názov aplikácie Power BI Desktop pri ukladaní do projektu.

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.

Prichytenie obrazovky zobrazujúce rozbaľovaciu ponuku názvu aplikácie Power BI Desktop.

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:

Prichytení obrazovky s informáciou, že sa nepodarilo otvoriť chybu súboru.

Podrobnosti schémy pre nasledujúce súbory nie sú zdokumentované. Počas ukážky nie sú podporované zmeny týchto súborov mimo aplikácie Power BI Desktop:

Nasadenie do pracovného priestoru služby Fabric

Pri práci so súbormi projektu Power BI môžete nasadiť svoj obsah do pracovného priestoru služby Fabric pomocou týchto mechanizmov na publikovanie:

Note

Publikovanie prostredníctvom publikovaní aplikácie Power BI Desktop pomocou používa dočasný súbor PBIX, ktorý je publikovaný v službe, podobne ako uloženie a publikovanie súboru PBIX. Na rozdiel od iných možností nasadenia PBIP, ktoré nasadzujú iba metaúdaje, táto metóda publikovania nasadí metaúdaje aj lokálnu vyrovnávaciu pamäť údajov sémantického modelu, ktorý sa upravuje.

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 pomocou externých nástrojov.
  • Úpravou metaúdajov TMDL v priečinku /definition pomocou nástroja VS Code alebo iného externého nástroja.

Všetky metaúdaje sémantického modelu sú prístupné na čítanie. Operácie zapisovania sú plne podporované, no uvedomte si, že úprava metaúdajov mimo aplikácie Power BI Desktop môže viesť k neočakávanému správaniu alebo v zriedkavých prípadoch môže viesť k nekonzistentnosti v rámci modelu. Pri vykonávaní zmien prostredníctvom externých nástrojov buďte opatrní.

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.

  • Tabuľky automatického dátumu vytvorené aplikáciou Power BI Desktop by sa nemali meniť pomocou externých nástrojov.

  • Ak má sémantický model povolenú funkciu Automatický dátum a čas a vytvoríte nový stĺpec dátumu a času mimo aplikácie Power BI Desktop, lokálna tabuľka dátumov sa nevygeneruje automaticky.

  • Sémantické modely, ako sú zložené modely alebo Direct Lake , môžu zahŕňať objekty a vlastnosti pochádzajúce z iných modelov alebo zdrojov údajov. Pri prispôsobovaní týchto vlastností alebo odstraňovaní synchronizovaných objektov power BI vyžaduje changedProperties nastavenie vlastnosti a PBI_RemovedChildren komentára. Tieto ukazovatele označia zmeny ako prispôsobenia používateľov, čím sa zabezpečí, že sa zachovajú počas ďalšej synchronizácie schémy so zdrojom údajov. Ďalšie informácie nájdete v téme Značky pôvodu pre sémantické modely služby Power BI.

  • Všetky úpravy výrazov mimo aplikácie Power BI Desktop v projekte s unappliedChanges.json sa po použití týchto zmien stratia.

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 súbory projektu sú k dispozícii v odkladacom priestore Git pre schémy json-schemas.

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í PBIP majte na pamäti, že maximálna dĺžka cesty pre súbory projektu je v systéme Windows predvolene obmedzená na 260 znakov. Keďže súbory PBIP sú uložené ako podpriečinky a súbory, dlhé názvy objektov, ako sú názvy tabuliek, môžu spôsobiť, že celková dĺžka cesty prekročí tento limit, čo bude mať za následok chyby počas operácií ukladania. Ak chcete zmierniť toto riziko, použite krátku cestu k priečinku ako koreňové umiestnenie pre PBIP.
  • V aplikácii Power BI Desktop nie je možné uložiť ako PBIP priamo do OneDrivu a SharePointu. Uložiť ako môžete použiť na uloženie súborov do lokálne synchronizovaného priečinka OneDrive. To však môže spôsobiť problémy so synchronizáciou súborov, čo môže viesť k neúspešným operáciám ukladania v aplikácii Power BI Desktop.
  • 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 zostavy (synonymá na stránke zostavy) nie sú podporované pre projekty Power BI.
  • Aplikácia Power BI Desktop používa crlf ako koniec riadka. Ak sa chcete vyhnúť problémom s rozdielmi, nakonfigurujte Git tak, aby spracovával konce riadkov povolením autocrlf.
  • Projekty Power BI nie sú v súčasnosti podporované vo verzii aplikácie Microsoft Power BI Desktop optimalizovanej pre Power BI Report Server.
  • Nie je možné získať a nastaviť členov roly zabezpečenia na úrovni riadkov pomocou rozhrania REST API prostriedkov
  • Nie je možné získať a nastaviť oddiely prírastkového obnovenia pomocou rozhrania REST API prostriedkov. Exportuje však jednu oblasť pomocou dotazu definovaného v politike obnovenia.

Najčastejšie otázky

Otázka: Pri pohľade na definície priečinkov sémantického modelu a položiek zostavy je len niekoľko súborov označených ako povinné, čo sa stane, ak ich odstránim?

Odpoveď: Power BI Desktop ich automaticky vytvorí pri uložení ako projekt (PBIP).

Otázka: Je Power BI Desktop informovaný 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 PBIX na PBIP, môžem ho skonvertovať späť na 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ť PBIX na PBIP a naopak programovo?

Odpoveď: Nie. PBIX môžete skonvertovať na PBIP a naopak iba pomocou možnosti Uložiť súbor>ako v akomore aplikácie Power BI Desktop.

Otázka: Môžem nasadiť projekt Power BI Desktop do služby 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 pri pripojení pracovného priestoru Fabric k Gitu nie je k dispozícii 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 slúži len 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.

Súvisiaci obsah

  • Last updated on