Sdílet prostřednictvím

Projekty Power BI Desktopu (PREVIEW)

  • Článek

Důležité

Projekty Power BI Desktopu jsou aktuálně ve verzi Preview.

Tip

Pokyny k plánování vývoje Power BI najdete v tématu Plánování implementace Power BI.

Power BI Desktop představuje nový způsob vytváření, spolupráce a ukládání projektů. Při ukládání práce jako projektu Power BI (PBIP) se definice položek sestavy a sémantického modelu uloží jako jednotlivé soubory prostého textu v jednoduché intuitivní struktuře složek.

Uložení práce jako projektu má následující výhody:

  • Podpora textového editoru – Definiční soubory položek jsou textové soubory ve formátu JSON obsahující sémantický model a metadata sestavy. Jsou veřejně zdokumentované a čitelné člověkem. I když soubory projektu podporují nástroje pro jednoduché úpravy textu, jako je Poznámkový blok, je lepší použít editor kódu, jako je Visual Studio Code (VS Code), který poskytuje bohaté prostředí pro úpravy, včetně intellisense, ověřování a integrace Gitu.

  • Programové generování a úpravy definic položek – můžete vytvářet skripty pomocí oblíbeného a snadno použitelného jazyka TMSL (Tabular Model Scripting Language) nebo vytvářet vlastní aplikace pro provádění změn definic položek. Aplikace můžou být založené na veřejné dokumentaci schémat definic položek nebo klientských knihoven.

  • Správa zdrojového kódu – definice sémantických modelů a položek sestavy Power BI se dají ukládat do systému správy zdrojového kódu, jako je Git. Pomocí Gitu můžete sledovat historii verzí, porovnávat revize (rozdíl) a vrátit se k předchozím verzím. Správa zdrojového kódu může také odblokovat spolupráci při používání Power BI Desktopu pomocí známých mechanismů spolupráce pro řešení konfliktů (sloučení) a kontrolou změn (žádosti o přijetí změn). Další informace najdete v tématu Správa verzí v Gitu.

  • Kontinuální integrace a průběžné doručování (CI/CD) – Můžete použít systémy, ve kterých vývojáři ve vaší organizaci odesílali navrhované změny do systému CI/CD. Systém pak tuto změnu ověří pomocí řady bran kvality před použitím změny v produkčním systému. Tyto brány kvality můžou zahrnovat kontroly kódu od jiných vývojářů, automatizované testování a automatizované sestavení, které ověří integritu změn. Systémy CI/CD jsou obvykle postavené na stávajících systémech správy zdrojového kódu. Další informace najdete v tématu DevOps – kontinuální integrace a DevOps – průběžné doručování.

Video

Podívejte se na projekty Power BI Desktopu a další funkce vývojářského režimu, které jsou představeny v Microsoft Buildu 2023.

Povolení ukázkových funkcí

Uložení jako projektu v Power BI Desktopu je aktuálně ve verzi Preview. Pokud chcete tuto funkci používat, potřebujete licenci Premuim a musíte ji povolit ve funkcích Preview.

Pokud chcete tuto možnost povolit, zaškrtněte v možnostech a>nastaveních>Možností> náhledu možností souboru v Power BI Desktopu> zaškrtávací políčko pro uložení projektu Power BI (.pbip).

Uložit jako projekt

Pokud pracujete na novém projektu nebo jste otevřeli existující soubor Power BI Desktopu (pbix), můžete svoji práci uložit jako soubor projektu Power BI (pbip):

Snímek obrazovky zobrazující uložení souboru jako Projekt Power BI

Když uložíte jako projekt, Power BI Desktop uloží položky sestavy a sémantického modelu jako složky, přičemž každý obsahuje textové soubory, které položku definují. Zobrazí se následující:

Snímek obrazovky zobrazující soubory Projectu Power BI

Po uložení jako projektu se můžete podívat, kdy pracujete na projektu, a to tak, že se podíváte na záhlaví:

Snímek obrazovky znázorňující název Power BI Desktopu při ukládání do projektu

Pokud kliknete na záhlaví, zobrazí se kontext, který je specifický pro Power BI Project. Díky tomu můžete vyhledat soubory projektu a také nastavení zobrazovaného názvu pro sestavu a sémantický model. Složku můžete otevřít také v Průzkumníku souborů kliknutím na cesty.

Snímek obrazovky s informačním rámečkem nadpisu Power BI Desktopu

Pojďme se podrobněji podívat na to, co vidíte v kořenové složce projektu:

<název> projektu. Sémantický model

Kolekce souborů a složek, které představují sémantický model Power BI. Další informace o souborech a podsložkách a souborech najdete ve složce Projektový sémantický model.

<název> projektu. Zpráva

Kolekce souborů a složek, které představují sestavu Power BI. Další informace osouborch

.gitIgnore

Určuje úmyslně nesledované soubory, které by Git měl ignorovat. Power BI Desktop vytvoří soubor .gitignore v kořenové složce, pokud ještě neexistuje.

Sémantický model a podsložky sestavy mají výchozí soubory gitu ignorované v souboru .gitIgnore:

├── project
│   ├── *.SemanticModel
│   │   ├── .pbi
│   │   │   ├── localSettings.json
│   │   │   └── cache.abf
│   ├── *.Report
│   │   ├── .pbi
│   │   │   └── localSettings.json
<název> projektu.pbip

Soubor PBIP obsahuje ukazatel na složku sestavy, otevření PBIP otevře cílovou sestavu a model pro vytváření.

Další informace najdete v dokumentu schématu pbip.

Otevření projektu Power BI

Power BI Desktop můžete otevřít ze složky Projektu Power BI tak, že otevřete soubor pbip nebo soubor pbir ve složce sestavy. Obě možnosti otevřou sestavu pro úpravy a sémantický model, pokud existuje relativní odkaz na sémantický model.

Do stejné složky můžete uložit více sestav a sémantických modelů. Samostatný soubor pbip pro každou sestavu není nutný, protože každou sestavu můžete otevřít přímo z souboru .pbir v rámci složky sestavy.

├── project
│   ├── AdventureWorks-Sales.Report
│   │   └── definition.pbir
│   ├── AdventureWorks-Stocks.Report
│   │   └── definition.pbir
│   ├── AdventureWorks.SemanticModel
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

Změny mimo Power BI Desktop

Při uložení jako projektu nejste nuceni provádět změny v sémantickém modelu a definicích sestav jenom v Power BI Desktopu. Můžete použít další nástroje, jako je VS Code, opensourcové komunitní nástroje, jako je tabulkový editor nebo dokonce Poznámkový blok. Ne každý soubor nebo změna ale podporuje úpravy externími opensourcovými nástroji.

Změny souborů nebo vlastností mimo Power BI Desktop můžou způsobit neočekávané chyby nebo dokonce zabránit otevření Power BI Desktopu. V takových případech musíte vyřešit problémy v souborech, než se pokusíte projekt znovu otevřít v Power BI Desktopu.

Pokud je to možné, Power BI Desktop indikuje soubor a umístění chyby:

Blokování obrazovky s nemožností otevřít chybu souboru

Podrobnosti schématu pro následující soubory nejsou zdokumentované. Ve verzi Preview se změny těchto souborů mimo Power BI Desktop nepodporují:

Vytváření modelů

K provedení změn definice sémantického modelu můžete použít externí nástroje dvěma způsoby:

  • Připojením k instanci Analysis Service (AS) Power BI Desktopu pomocí externích nástrojů.
  • Úpravou metadat JSON v souboru model.bim pomocí VS Code nebo jiného externího nástroje

Ne každý objekt modelu podporuje operace zápisu. Použití změn mimo podporované můžou způsobit neočekávané výsledky.

Objekty, které podporují operace zápisu:

Object Připojení k instanci AS Změna souboru
Tabulky No Ano
Sloupce Ano 1, 2 Ano
Počítané tabulky Ano Yes
Počítané sloupce Ano Yes
Hierarchie Ano Yes
Relace Ano Yes
Opatření Ano Yes
Klíčové ukazatele výkonu modelu Ano Yes
Skupiny výpočtů Ano Yes
Perspektivy Ano Yes
Překlady Ano Yes
Zabezpečení na úrovni řádků (RLS) Ano Yes
Zabezpečení na úrovni objektů (OLS) Ano Yes
Poznámky Ano Yes
Výrazy jazyka M No Ano 3, 4

Pamatujte si, že:

  • Všechny změny při otevírání souborů provedených mimo Power BI Desktop vyžadují restartování, aby se tyto změny zobrazily v Power BI Desktopu. Power BI Desktop neví o změnách souborů projektu provedených jinými nástroji.

  • Power BI Desktop nepodporuje tabulky s více oddíly. Podporuje se jenom jeden oddíl pro každou tabulku. Při vytváření tabulek s prázdnými oddíly nebo více než jedním oddílem dojde při otevření sestavy k chybě.

  • Automatické tabulky kalendářních dat vytvořené Power BI Desktopem by se neměly měnit pomocí externích nástrojů.

  • Při změně modelu, který používá Direct Query pro připojení sémantického modelu Power BI nebo modelu Analysis Services, musíte aktualizovat Změněnéproperties a PBI_RemovedChildren kolekce, aby změněný objekt zahrnoval všechny změněné nebo odebrané vlastnosti. Pokud se Změnyproperties nebo PBI_RemovedChildren neaktualizují, Power BI Desktop může při příští úpravě dotazu přepsat všechny změny nebo se model aktualizuje v Power BI Desktopu.

  • 1 . Změna datového typu sloupce je podporována. Přejmenování sloupců se ale při připojování k instanci AS nepodporuje.

  • 2 – Pokud má sémantický model povolenou funkci Automatické datum a čas a vytvoříte nový sloupec datetime mimo Power BI Desktop, místní tabulka kalendářních dat se automaticky nevygeneruje.

  • 3 . Typ zdroje oddílu musí být Počítaný, M, Entita nebo CalculateGroup. Režim oddílu musí být Import, DirectQuery nebo Duální.

  • 4 – Všechny úpravy výrazů mimo Power BI Desktop v projektu s unappliedChanges.json se při použití těchto změn ztratí.

  • Úprava výrazů dotazu tabulky mimo Power BI Desktop způsobí odebrání dat tabulky po restartování Power BI Desktopu.

Schémata souborů JSON

Většina souborů projektu obsahuje metadata ve formátu JSON. K ověření a dokumentaci je možné použít odpovídající schémata JSON.

Pomocí schémat JSON můžete:

  • Seznamte se s konfigurovatelnými vlastnostmi.
  • Použijte vložené ověřování JSON poskytnuté editorem kódu.
  • Vylepšení vytváření pomocí zvýrazňování syntaxe, popisů a automatického dokončování
  • Používejte externí nástroje se znalostmi podporovaných vlastností v metadatech projektu.

Pomocí editoru VS Code namapujte schémata JSON na vytvářené soubory. Schémata JSON pro soubory projektu jsou k dispozici v úložišti Git s ukázkami Power BI Desktopu.

Úvahy a omezení

  • Power BI Desktop nezná změny provedené v jiných nástrojích nebo aplikacích. Změny provedené pomocí externích nástrojů vyžadují, abyste před zobrazením těchto změn restartovali Power BI Desktop.
  • Popisky citlivosti nejsou u projektů Power BI podporované.
  • Při úpravách modelů ve službě se ignoruje zobrazení diagramu.
  • Při ukládání jako projektu Power BI je maximální délka cesty k souborům projektu 260 znaků.
  • V Power BI Desktopu se nedá uložit jako PBIP přímo na OneDrive a SharePoint.
  • Při úpravách souborů PBIP mimo Power BI Desktop by se měly ukládat pomocí UTF-8 bez kódování BOM.
  • Lingvistické schéma sestavy není podporováno u projektů Power BI.
  • Power BI Desktop používá crLF jako konec řádku. Pokud se chcete vyhnout problémům v rozdílech, nakonfigurujte Git tak, aby zpracovával konce řádků povolením automatického šifrování.
  • Projekty Power BI se v současné době nepodporují ve verzi Microsoft Power BI Desktopu optimalizované pro Server sestav Power BI.

Nejčastější dotazy

Otázka: Když se podíváte na sémantický model a definice složek položek sestavy, označí se jako povinné jenom několik souborů, co se stane, když je odstraním?

Odpověď: Power BI Desktop je automaticky vytvoří při uložení jako projekt (PBIP).

Otázka: Je Power BI Desktop o změnách, které provádím v souborech Projektu Power BI z externího nástroje nebo aplikace?

Odpověď: Ne. Všechny změny provedené v souborech vyžadují restartování Power BI Desktopu, aby tyto změny odrážely.

Otázka: Pokud převedem PBIX na PBIP, můžu ho převést zpět na PBIX?

Odpověď: Ano. Soubor PBIX můžete uložit jako PBIP nebo soubor PBIP uložit jako PBIX.

Otázka: Můžu programově převést PBIX na PBIP a naopak?

Odpověď: Ne. Soubor PBIX můžete převést jenom na PBIP a naopak pomocí funkce Uložit soubor>v Power BI Desktopu jako.

Otázka: Můžu nasadit projekt Power BI Desktopu do služby Azure Analysis Services (AAS) nebo Služba Analysis Services serveru SQL (SSAS)?

Odpověď: Ne. Definice sestav projektu Power BI Desktopu nejsou v AAS a SSAS podporované. Definice modelu používají vylepšená metadata jedinečná pro Power BI. V případě projektů AAS a SSAS použijte Microsoft Visual Studio pro integraci vytváření modelů, Gitu a Azure DevOps.

Otázka: Proč neexistuje soubor *.pbip, když připojím pracovní prostor Fabric k Gitu? Jak můžu upravit sestavu a sémantický model v Power BI Desktopu?

Odpověď: Soubor PBIP je volitelný a jednoduše slouží jako zástupce složky sestavy. Sestavu i sémantický model pro úpravy v Power BI Desktopu můžete otevřít otevřením souboru definition.pbir umístěného ve složce sestavy.

Související obsah