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

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ámogatja a – Az elemdefiníciós 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.

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

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

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:

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:

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

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.

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
|   |   └── *.*
│   .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. 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ö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:

• Jelentés\
  • report.json
  • mobileState.json
  • semanticModelDiagramLayout.json
• SzemanticModel\
  • diagramLayout.json

Ü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:

• Fabric Git Integrationhasználata.
• Használd a Fabric API-kat.
• Használja Power BI Desktop közzétételi beállítását.

Modellkészítés

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

• Ha külső eszközökkel csatlakozik a Power BI Desktop Analysis Service (AS) példányához.
• A JSON-metaadatok a model.bim fájlban a VS Code vagy más külső eszköz használatával történő szerkesztésével.

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:

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, előfordulhat, hogy a Power BI Desktop felülírja 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

• 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 az Power BI jelentéskészítő kiszolgáló optimalizált Microsoft Power BI Desktop-verzióban.
• A PBIP-ként mentett élő kapcsolati jelentésekhez engedélyezni kell az XMLA-végpontot .

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

• A Power BI Desktop projekt szemantikai modellmappája
• A Power BI Desktop projektjelentési mappája
• Power BI Desktop-projektek Git-integrációja
• Power BI Desktop-projektek Azure DevOps-integráció
• Külső eszközök a Power BI Desktopban