Megosztás a következőn keresztül:

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

Fontos

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

Tipp.

A Power BI-fejlesztés megtervezésével kapcsolatos útmutatásért tekintse meg a Power BI implementálásának tervezését ismertető témakört.

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 – A PBIP-fájlok szemantikai modellt és jelentés metaadatokat tartalmazó formázott szövegfájlok. Ezek a fájlok nyilvánosan dokumentálva és emberileg olvashatók. Bár a projektfájlok támogatják az olyan egyszerű szövegszerkesztő eszközöket, mint a Jegyzettömb, érdemesebb olyan kódszerkesztőt használni, mint a Visual Studio Code (VS Code), amely gazdag szerkesztési élményt nyújt, beleértve az intellisense, az ellenőrzés és a Git-integrációt.

  • Mappastruktúra átlátszósága – Különítse el a szemantikai modell és jelentés mappáit, így hatékony, mégis egyszerű feladatokat tesz lehetővé, például a szemantikai modelltáblák projektek közötti másolását vagy a jelentésoldalak újrafelhasználását. Nagyszerű választás fejlesztési sablonok létrehozásához és újbóli használatához.

  • A forráskövetés készen áll – Szövegfájlok megnyitása a Gittel való zökkenőmentes integrációhoz, lehetővé téve a verzióelőzményeket és a csapatmunkát. További információ: Verziókövetés a Gitben.

  • Folyamatos integráció és folyamatos teljesítés (CI/CD) támogatása – CI/CD-eljárásokat alkalmazhat meglévő forrásvezérlő rendszereire PBIP-fájlok használatával, minőségi kapuk beépítésével és az éles környezetekben való üzembe helyezés automatizálásával. Ha többet szeretne megtudni a CI/CD-ről a Fabricben, tekintse meg a Fabric CI/CD munkafolyamatait.

  • Programozott létrehozás és elemdefiníciók szerkesztése – Programozott módon hozhat létre és módosíthat elemdefiníciós szövegfájlokat, lehetővé téve a kötegműveleteket, például az összes jelentésoldal vizualizációjának frissítését vagy mértékkészletek hozzáadását az egyes táblákhoz. Szemantikai modellek esetén a táblázatos objektummodell (TOM) ügyfélkódtár használatával deszerializálhatja a szemantikai modell metaadatait, programozott módosításokat végezhet, és szerializálhatja a fájlokat.

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

A Power BI Desktopban power BI-projektként való mentés jelenleg előzetes verzióban érhető el, és engedélyeznie kell azt az előzetes verziójú funkciókban.

Nyissa meg a Fájlbeállítások > és beállítások > – > Előzetes verziójú funkciók lehetőséget , és jelölje be a Power BI Project (.pbip) mentési lehetőség melletti jelölőnégyzetet.

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

Ha projektként ment, a Power BI Desktop mappákként menti a jelentés- és szemantikai modellelemeket, amelyek mindegyike az elemet meghatározó szövegfájlokat tartalmazza:

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

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. 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 Project-fájlok, például a cache.abf és a localSettings.json esetében.

A Power BI Desktop csak akkor hozza létre a .gitignore fájlt, ha még nem létezik a kiválasztott mentési mappában vagy szülő Git-adattárban.

A .gitignore alapértelmezett tartalma PBIP-ként való mentéskor:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<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ó: pbip sémadokumentum.

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/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

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 kiválasztja a címsort, megjelenik egy, a Power BI Projectre jellemző úszó ablak. Ez a úszó panel 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.

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. Használhat más eszközöket, 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 a Jegyzettömbet 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:

Üzembe helyezés a Fabric-munkaterületen

A Power BI-projektfájlok használatakor a tartalmat a következő közzétételi mechanizmusokkal helyezheti üzembe egy Fabric-munkaterületen:

Jegyzet

Az Power BI Desktop közzétételi a szolgáltatásban közzétett ideiglenes PBIX-fájlt használ, hasonlóan a PBIX-fájlok mentéséhez és közzétételéhez. Más, csak metaadatokat üzembe helyező PBIP-telepítési lehetőségekkel ellentétben ez a közzétételi módszer a szerkeszteni kívánt szemantikai modell metaadatait és helyi adatgyorsítótár- is üzembe helyezi.

Modellkészítés

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

Minden szemantikai modell metaadatai olvashatók. Az írási műveletek teljes mértékben támogatottak, azonban vegye figyelembe, hogy a Metaadatok Power BI Desktopon kívüli módosítása váratlan viselkedést eredményezhet, vagy ritkán következetlenségekhez vezethet a modellen belül. A külső eszközökkel végzett módosításoknál körültekintően kell eljárni.

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 által létrehozott automatikus dátumtáblákat nem szabad külső eszközökkel módosítani.

  • 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.

  • A szemantikai modellek – például az összetett modellek vagy a Direct Lake – tartalmazhatnak más modellekből vagy adatforrásokból származó objektumokat és tulajdonságokat. A tulajdonságok testreszabása vagy a szinkronizált objektumok eltávolításakor a Power BI megköveteli a changedProperties tulajdonság és a PBI_RemovedChildren széljegyzet beállítását. Ezek a mutatók felhasználói testreszabásként jelölik meg a módosításokat, biztosítva, hogy azok megmaradnak az adatforrással való következő séma-szinkronizálás során. További információkért tekintse meg a Power BI szemantikai modelljeinek vonalcímkéket.

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

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 json-schemas Git adattárban találhatók.

Szempontok és korlátozások

  • 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 Mentés másként használatával fájlokat menthet egy helyileg szinkronizált OneDrive-mappába; Ez azonban fájlzárolási problémákat okozhat, ami a Power BI Desktopban sikertelen mentési műveletekhez vezethet.
  • 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 az Power BI jelentéskészítő kiszolgáló optimalizált Microsoft Power BI Desktop-verzióban.

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> 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.

Kérdés: Miért nem található *.pbip fájl, amikor a Fabric-munkaterületet a Githez csatlakoztatom? Hogyan szerkeszthetem a jelentést és a szemantikai modellt a Power BI Desktopban?

Válasz: A PBIP-fájl nem kötelező, és egyszerűen a jelentésmappára mutató parancsikonként szolgál. A Power BI Desktopban a jelentés és a szemantikai modell szerkesztéséhez is megnyithatja a jelentésmappában található definition.pbir fájlt.

Kapcsolódó tartalom