Power BI Desktop-projektek (ELŐZETES VERZIÓ)

  • Cikk

Fontos

A Power BI Desktop-projektek jelenleg előzetes verzióban érhetőek el.

A Power BI Desktop új módszert mutat be a projektek létrehozására, együttműködésére és mentésére. Ha Power BI-projektként (PBIP) menti a munkáját, a jelentés- és szemantikai modellelem-definíciók egyszerű szöveges fájlokként lesznek mentve egy egyszerű, intuitív mappastruktúrában.

A munka projektként való mentése a következő előnyökkel jár:

  • Szövegszerkesztő támogatása – Az elemdefiníciós fájlok olyan JSON formátumú szövegfájlok, amelyek szemantikai modellt és jelentés metaadatokat tartalmaznak. Nyilvánosan dokumentált és emberileg olvasható. Bár a projektfájlok támogatják az egyszerű szövegszerkesztési eszközöket, például a Jegyzettömb, jobb, ha olyan kódszerkesztőt használ, mint a Visual Studio Code (VS Code), amely gazdag szerkesztési élményt nyújt, beleértve az intellienset, az ellenőrzést és a Git-integrációt.

  • Programozott létrehozás és elemdefiníciók szerkesztése – Létrehozhat szkripteket a népszerű és könnyen használható táblázatos modellszkriptnyelv (TMSL) használatával, vagy létrehozhat saját egyéni alkalmazásokat az elemdefiníciók módosításához. Az alkalmazások az elemdefiníciós sémák és/vagy ügyfélkódtárak nyilvános dokumentációján alapulhatnak.

  • Forrásvezérlés – A Power BI szemantikai modellje és jelentéselem-definíciói egy forrásvezérlő rendszerben, például a Gitben tárolhatók. A Git segítségével nyomon követheti a verzióelőzményeket, összehasonlíthatja a változatokat (diff), és visszaállíthatja a korábbi verziókat. A forrásvezérlés a Power BI Desktop használata esetén is feloldhatja az együttműködést az ütközések feloldására (egyesítésére) és a módosítások (lekéréses kérelmek) áttekintésére szolgáló ismert együttműködési mechanizmusok használatával. További információ: Verziókövetés a Gitben.

  • Folyamatos integráció és folyamatos teljesítés (CI/CD) – Olyan rendszereket használhat, ahol a szervezet fejlesztői javasolt módosítást küldenek a CI/CD rendszerre. A rendszer ezt követően számos minőségi kapuval ellenőrzi a változást, mielőtt a módosítást az éles rendszerre alkalmazták. Ezek a minőségi kapuk tartalmazhatnak más fejlesztők által végzett kódellenőrzéseket, automatizált tesztelést és automatizált buildelést a módosítások integritásának ellenőrzéséhez. A CI/CD rendszerek általában a meglévő forrásvezérlő rendszerekre épülnek. További információ: DevOps – Folyamatos integráció és DevOps – Folyamatos teljesítés.

Videó

Tekintse meg a Microsoft Build 2023-ban bevezetett Power BI Desktop-projekteket és más fejlesztői módú funkciókat.

Előnézeti funkciók engedélyezése

A Mentés projektként a Power BI Desktopban jelenleg előzetes verzióban érhető el. A funkció használatához Premuim-licencre van szüksége, és engedélyeznie kell az előzetes verziójú funkciókban.

Az engedélyezéshez a Power BI Desktop >Fájlbeállítások>és beállítások>>előzetes verziójú funkcióiban jelölje be a Power BI Project (.pbip) mentési beállításának jelölőnégyzetét.

Mentés projektként

Ha új projekten dolgozik, vagy megnyitott egy meglévő Power BI Desktop-fájlt (pbix), a munkáját Power BI-projektfájlként (pbip) mentheti:

Képernyőfelvétel a Fájl mentése Power BI-projektként való megjelenítéséről

Projektként történő mentéskor a Power BI Desktop mappákként menti a jelentés- és szemantikai modellelemeket, amelyek mindegyike az elemet meghatározó szövegfájlokat tartalmazza. A következők láthatók:

Képernyőfelvétel a Power BI Project-fájlokról

A projektként való mentés után a címsorban láthatja, hogy mikor dolgozik egy projekten:

Képernyőkép a Power BI Desktop címének megjelenítéséről a projektbe való mentéskor.

Ha a címsorra kattint, megjelenik egy, a Power BI Projectre jellemző úszó ablak. Ez lehetővé teszi a projektfájlok, valamint a jelentés és a szemantikai modell megjelenítési névbeállításainak megkeresését. A mappát az elérési utakra kattintva is megnyithatja a Fájlkezelőben.

A Power BI Desktop címfeliratát megjelenítő képernyőfelvétel.

Nézzük meg közelebbről, mit lát a projekt gyökérmappájában:

<projekt neve>. SzemanticModel

Power BI szemantikai modellt képviselő fájlok és mappák gyűjteménye. Tartalmazza azokat a legfontosabb fájlokat, mint például a model.bim. Az itt található fájlokról, almappákról és fájlokról további információt a Project Szemantikai modell mappájában talál.

<projekt neve>. Jelentés

Power BI-jelentést képviselő fájlok és mappák gyűjteménye. Az itt található fájlokról, almappákról és fájlokról további információt a Project jelentésmappájában talál.

.gitIgnore

A szándékosan nem követett fájlokat adja meg, amelyeket a Gitnek figyelmen kívül kell hagynia. A Power BI Desktop akkor hozza létre a .gitignore fájlt a gyökérmappában, ha még nem létezik.

A szemantikai modell és a jelentés almappái a .gitIgnore-ban megadott alapértelmezett git figyelmen kívül hagyott fájlokkal rendelkeznek:

├── project
│   ├── *.SemanticModel
│   │   ├── .pbi
│   │   │   ├── localSettings.json
│   │   │   └── cache.abf
│   ├── *.Report
│   │   ├── .pbi
│   │   │   └── localSettings.json
<projekt neve.pbip>

A PBIP-fájl egy jelentésmappára mutató mutatót tartalmaz, a PBIP megnyitásakor megnyílik a megcélzott jelentés és a létrehozási modell.

További információkért tekintse meg a pbip-sémadokumentumot.

Power BI-projekt megnyitása

A Power BI Desktopot a Power BI Project mappából is megnyithatja a pbip- vagy a pbir-fájl megnyitásával a jelentésmappában. Mindkét lehetőség megnyitja a jelentést szerkesztésre, és a szemantikai modellt, ha relatív hivatkozás van egy szemantikai modellre.

Több jelentést és szemantikai modellt is menthet ugyanahhoz a mappához. Nincs szükség külön pbip-fájlra az egyes jelentésekhez, mert az egyes jelentéseket közvetlenül a jelentésmappában lévő .pbir fájlból nyithatja meg.

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

Változások a Power BI Desktopon kívül

Projektként mentve nem kell módosítania a szemantikai modellt és a jelentésdefiníciókat csak a Power BI Desktopban. Más eszközöket is használhat, például a VS Code-ot, a nyílt forráskódú közösségi eszközöket, például a Táblázatszerkesztőt, vagy akár Jegyzettömb is. Azonban nem minden fájl vagy módosítás támogatja a külső, nyílt forráskódú eszközökkel történő szerkesztést.

A Power BI Desktopon kívüli fájlok vagy tulajdonságok módosítása váratlan hibákat okozhat, vagy akár a Power BI Desktop megnyitását is megakadályozhatja. Ezekben az esetekben meg kell oldania a fájlokkal kapcsolatos problémákat, mielőtt újra megkísérlené megnyitni a projektet a Power BI Desktopban.

Ha lehetséges, a Power BI Desktop a hibafájlt és a hiba helyét jelzi:

A képernyő megragadása, hogy nem lehet megnyitni a fájlhibát.

A következő fájlok sémaadatai nincsenek dokumentálva. Az előzetes verzióban a Power BI Desktopon kívüli fájlok módosításai nem támogatottak:

Modellkészítés

Külső eszközökkel kétféleképpen módosíthatja a szemantikai modell definícióját:

Nem minden modellobjektum támogatja az írási műveleteket. A támogatottakon kívüli módosítások alkalmazása váratlan eredményeket okozhat.

Írási műveleteket támogató objektumok:

Objektum Csatlakozás AS-példányra Fájlmódosítás
Táblák Nem Igen
Oszlopok Igen 1, 2 Igen
Számított táblák Igen Igen
Számított oszlopok Igen Igen
Hierarchiák Igen Igen
Kapcsolatok Igen Igen
Mértékek Igen Igen
Modell KPI-k Igen Igen
Számítási csoportok Igen Igen
Perspektívák Igen Igen
Fordítások Igen Igen
Sorszintű biztonság (RLS) Igen Igen
Objektumszintű biztonság (OLS) Igen Igen
Jegyzetek Igen Igen
M-kifejezések Nem Igen 3, 4

Tartsa szem előtt a következőket:

  • A Power BI Desktopon kívül végrehajtott fájlok megnyitásához újra kell indítani a módosításokat a Power BI Desktopban. A Power BI Desktop nem ismeri a projektfájlok más eszközök által végzett módosításait.

  • A Power BI Desktop nem támogatja a több partícióval rendelkező táblákat. Az egyes táblákhoz csak egyetlen partíció támogatott. Ha üres vagy több partíciót tartalmazó táblákat hoz létre, a jelentés megnyitásakor hiba történik.

  • A Power BI Desktop által létrehozott automatikus dátumtáblákat nem szabad külső eszközökkel módosítani.

  • Ha olyan modellt módosít, amely Direct Queryt használ a Power BI szemantikai modell vagy az Analysis Services-modell összekapcsolásához, frissítenie kell a Módosított segédek és PBI_RemovedChildren gyűjteményt, hogy a módosított objektum tartalmazza a módosított vagy eltávolított tulajdonságokat. Ha a ChangedProperties és/vagy a PBI_RemovedChildren nem frissül, a Power BI Desktop felülírhatja a módosításokat a lekérdezés következő szerkesztésekor vagy a modell Power BI Desktopban való frissítésekor.

  • 1 – Az oszlop adattípusának módosítása támogatott. Az AS-példányhoz való csatlakozáskor azonban az oszlopok átnevezése nem támogatott.

  • 2 – Ha a szemantikai modellben engedélyezve van az Automatikus dátum/idő funkció, és a Power BI Desktopon kívül hoz létre egy új dátum/idő oszlopot, a helyi dátumtábla nem jön létre automatikusan.

  • 3 – A partíció forrástípusának számítottnak, M-nek, entitásnak vagy CalculationGroup-nak kell lennie. A partíciós módnak importálásnak, DirectQuerynek vagy kettősnek kell lennie.

  • 4 – A Power BI Desktopon kívüli, unappliedChanges.json rendelkező projektekben végzett kifejezések a módosítások alkalmazásakor elvesznek.

  • Ha a power BI Desktopon kívül módosítja a táblalekérdezési kifejezéseket, akkor a Power BI Desktop újraindításakor a táblaadatok el lesznek távolítva.

JSON-fájlséma

A legtöbb projektfájl JSON formátumban tartalmaz metaadatokat. A megfelelő JSON-sémák használhatók az ellenőrzéshez és a dokumentációhoz.

JSON-sémákkal a következőt teheti:

  • Tudnivalók a konfigurálható tulajdonságokról.
  • Használja a kódszerkesztő által biztosított beágyazott JSON-ellenőrzést.
  • A szintaxis kiemelésével, elemleírásaival és automatikus kiegészítésével javíthatja a szerkesztést.
  • Külső eszközök használata a projekt metaadataiban támogatott tulajdonságok ismeretével.

A VS Code használatával JSON-sémákat képezhet le a létrehozott fájlokra. A projektfájlok JSON-sémái a Power BI Desktop Git-adattárában találhatók.

Szempontok és korlátozások

  • Ehhez a funkcióhoz prémium szintű licenc szükséges.
  • A Power BI Desktop nem ismeri a más eszközökkel vagy alkalmazásokkal végzett módosításokat. A külső eszközökkel végzett módosításokhoz a módosítások megjelenítése előtt újra kell indítania a Power BI Desktopot.
  • A bizalmassági címkék nem támogatottak a Power BI-projektekben.
  • A diagramnézet figyelmen kívül lesz hagyva, amikor modelleket szerkeszt a szolgáltatásban.
  • Power BI-projektként való mentéskor a projektfájlok elérési útja legfeljebb 260 karakter hosszúságú lehet.
  • A Power BI Desktopban nem menthet PBIP-ként közvetlenül a OneDrive-ra és a SharePointba.
  • A PBIP-fájlok Power BI Desktopon kívüli szerkesztésekor az UTF-8 használatával kell menteni őket BOM kódolás nélkül.
  • A jelentés nyelvi sémája nem támogatott a Power BI-projektekben.
  • A Power BI Desktop a CRLF-et használja sorvégként. A diffekkel kapcsolatos problémák elkerülése érdekében konfigurálja a Gitet a vonalvégzések kezelésére az autocrlf engedélyezésével.
  • A Power BI-projektek jelenleg nem támogatottak a Microsoft Power BI Desktopban (Power BI jelentéskészítő kiszolgáló optimalizálva).

Gyakori kérdések

Kérdés: A szemantikai modell és a jelentéselem mappadefinícióit tekintve csak néhány fájl van megjelölve kötelezőként, mi történik, ha törölöm őket?

Válasz: A Power BI Desktop automatikusan létrehozza őket, amikor projektként (PBIP) menti őket.

Kérdés: Tud a Power BI Desktop a Power BI Project-fájlok külső eszközről vagy alkalmazásról végzett módosításairól?

Válasz: Nem A fájlokon végzett módosítások miatt a Power BI Desktopot újra kell indítani a módosításoknak megfelelően.

Kérdés: Ha PBIX-et PBIP-vé konvertálok, vissza lehet konvertálni PBIX-vé?

Válasz: Igen. A PBIX-eket PBIP-ként vagy PBIX-ként is mentheti.

Kérdés: Átalakíthatom a PBIX-t PBIP-vé, és fordítva programozott módon?

Válasz: Nem A PBIX-et csak PBIP-re konvertálhatja, és fordítva a Power BI Desktop Fájlmentés>másként funkciójával.

Kérdés: Üzembe helyezhetek egy Power BI Desktop-projektet az Azure Analysis Servicesben (AAS) vagy az SQL Server Analysis Servicesben (SSAS)?

Válasz: Nem Az AAS és az SSAS nem támogatja a Power BI Desktop projektjelentés-definícióit. A modelldefiníciók pedig a Power BI-ra jellemző továbbfejlesztett metaadatokat használják. AAS- és SSAS-projektek esetén a Microsoft Visual Studio használatával modellkészítést, Git- és Azure DevOps-integrációt használhat.

Kapcsolódó tartalom