A Power BI Desktop projekt szemantikai modellmappája

Fontos

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

Ez a cikk a Microsoft Power BI Desktop projekt Szemantikai modell mappájában található fájlokat és almappákat ismerteti. Az itt található fájlok és almappák Egy Power BI szemantikai modellt képviselnek. A projekttől függően a szemantikai modell mappája a következőket tartalmazhatja:

1 – Ez a fájl szükséges.
2 – Ez a fájl TMSL formátummal történő mentéskor szükséges.
3 – Ez a fájl TMDL formátummal történő mentéskor szükséges.

Nem minden projekt szemantikai modellmappája tartalmazza az itt leírt összes fájlt és almappát.

Szemantikai modellfájlok

.pbi\localSettings.jsbekapcsolva

Szemantikai modellbeállításokat tartalmaz, amelyek csak az aktuális felhasználóra és számítógépre vonatkoznak. A gitIgnore-ban vagy más forrásvezérlési kizárásokban kell szerepelnie. Alapértelmezés szerint a Git figyelmen kívül hagyja ezt a fájlt.

További információ: localSettings.json sémadokumentum.

.pbi\editorSettings.jsbekapcsolva

A szemantikai modell szerkesztőbeállításait tartalmazza, amelyet a szemantikai modell definíciójának részeként mentettek a felhasználók és a környezetek közötti használatra.

További információ: editorSettings.json sémadokumentum.

.pbi\cache.abf

Analysis Services backup (ABF) fájl, amely a modell és az adatok helyi gyorsítótárazott másolatát tartalmazza, amikor utoljára szerkesztették. A gitIgnore-ban vagy más forrásvezérlési kizárásokban kell szerepelnie. Alapértelmezés szerint a Git figyelmen kívül hagyja ezt a fájlt.

A Power BI Desktop gyorsítótár.abf fájl nélkül is megnyithat egy projektet. Ebben az esetben a teljes definícióval rendelkező, de adatok nélküli modellhez kapcsolódó jelentést nyitja meg. Ha létezik cache.abf, a Power BI Desktop betölti az adatokat, és felülírja a modelldefiníciót a projekt szemantikai modell metaadataival.

.pbi\unappliedChanges.jsbekapcsolva

A Power BI Desktop segítségével az Adatátalakítás szerkesztőben (Power Query) végrehajtott módosításokat anélkül mentheti, hogy először alkalmazná ezeket az adatmodellre.

Kép az alkalmazott lekérdezésmódosító párbeszédpanelről.

Ha később az Alkalmaz elemet választja, a nem jóváhagyott módosítások a unappliedChanges.json fájlba lesznek mentve. Ha a függőben lévő módosítások a nem jóváhagyottChanges fájlban vannak, a Power BI Desktop felszólítja a függőben lévő módosítások alkalmazására vagy elvetésére:

A függőben lévő módosításokra figyelmeztető kép.

Ha a Módosítások alkalmazása lehetőséget választja, a Power BI Desktop felülírja a szemantikai modell metaadataiban szereplő lekérdezéseket a unappliedChanges.jsonlekérdezéseivel. Ha a Power BI Desktopon kívül szerkesztett lekérdezéseket, és van egy korábbi unappliedChanges.json fájl, a módosítások elvesznek, és a módosítások alkalmazásakor a módosítások unappliedChanges.json lekérdezései váltják fel őket.

Az unappliedChanges.json fájl automatikusan beépül a szemantikai modell definíciójába, és alapértelmezés szerint a Gitbe mentődik. Ez lehetővé teszi, hogy véglegesítse a folyamatban lévő munkáját a fejlesztési ágon, amely biztonsági mentésként szolgál, és elérhetővé teszi azt más csapattagok számára. Azonban kizárhatja ezt a fájlt a Git nyomon követéséből, megakadályozva, hogy a befejezetlen lekérdezési munka más fejlesztőket is érintsen.

További információ: unappliedChanges.json sémadokumentum.

definition.pbism

A szemantikai modell és az alapvető beállítások általános definícióját tartalmazza.

Ez a fájl a támogatott szemantikai modelldefiníciós formátumokat is megadja a "version" tulajdonságon keresztül.

Verzió Támogatott formátumok
1.0 A szemantikai modell definícióját TMSL-ként kell tárolni a model.bim fájlban.
4.0 vagy újabb A szemantikai modelldefiníció TMSL (model.bim fájl) vagy TMDL (\definition mappa) néven tárolható.

További információ: definition.pbism sémadokumentum.

model.bim

Ez a fájl csak akkor érhető el, ha a Power BI-projekt TMSL formátumban mentésre kerül. Táblázatos modellszkriptnyelvet (TMSL) tartalmaz a projektmodell adatbázis-objektumdefiníciója .

definíciók\ mappa

Ez a mappa csak akkor érhető el, ha a Power BI-projektet TMDL formátumban menti a rendszer. Lecseréli a model.bim fájlt.

Ez a mappa a projektmodell táblázatos modelldefiníciós nyelvét (TMDL)tartalmazó adatbázis-objektumdefiníciót tartalmazza.

diagramLayout.json

Diagram metaadatait tartalmazza, amelyek meghatározzák a jelentéshez társított szemantikai modell struktúráját. Az ELŐZETES VERZIÓban ez a fájl nem támogatja a külső szerkesztést.

.platform

Hálóplatform-fájl, amely a Fabric-elemek és a Git közötti kapcsolat létrehozásához és fenntartásához elengedhetetlen tulajdonságokat tartalmazza.

További információ: Git-integráció automatikusan létrehozott rendszerfájlok.

DAXQueries\ mappa

Mindegyik DAX-lekérdezésnézet lekérdezési laphoz tartozik egy fájl, amely DAX-fájlként van mentve.

.pbi\daxQueries.json

DAX-lekérdezésnézet-szerkesztőbeállításokat tartalmaz, például defaultTab vagy tabulátorsorrendet.

TMDLScripts\ mappa

Az egyes TMDL-nézetszkript-fülekhez[Tab name].tmdl tartozó fájlok TMDL-fájlként vannak mentve.

.pbi\tmdlscripts.json

TMDL nézet szerkesztő beállításait tartalmazza, mint például az alapértelmezett lapfül vagy a lapfülek sorrendje.

TMDL formátum

A jobb forráskövetési és közös fejlesztési élmény biztosítása érdekében a Power BI Project-fájlokat (PBIP) a táblázatos modelldefiníciós nyelv (TMDL) használatával mentheti szemantikai modellfájlformátumként.

A táblázatos modellszkriptnyelvtől (TMSL) ellentétben a TMDL-t az alapoktól kezdve úgy tervezték, hogy emberbarát legyen, ami nem csak olvashatóságot , hanem egyszerű szerkesztést is biztosít bármely szövegszerkesztőben. Ez jelentős fejlesztést jelent a forráskontroll és az együttműködésen alapuló fejlesztési élmény terén.

Képernyőkép a felhasználóbarát TMDL-diffekről.

A TMDL-hez hasonló nagy JSON-fájl, például a Táblázatos modell szkriptnyelve (TMSL) helyett a TMDL mappaszerkezettel rendelkezik, amely külön fájlokat tartalmaz az egyes táblákhoz, perspektívákhoz, szerepkörökhöz és kulturális környezetekhez. Ez megkönnyíti a másokkal való munkát, valamint a szemantikai modell szerkezetének megértését a mappa és a fájlok megtekintésével. Ez végső soron a git diff és az egyesítési ütközések kezelésekor kiváló forráskövetési és társfejlesztési tapasztalathoz vezet.

Képernyőkép a szemantikai modell TMDL-diffjeiről.

További információ a TMDL-ről itt.

A TMDL formátum előzetes verziójának engedélyezése funkció

A TMDL használatával power BI-projektként történő mentés jelenleg előzetes verzióban érhető el. Használat előtt először engedélyeznie kell az előnézeti funkciókban.

Nyissa meg a Fájl Opciók és beállítások > Opciók > – > Előnézeti funkciók, és jelölje be a TMDL formátumot használó szemantikai modell tárolása melletti jelölőnégyzetet.

Mentés projektként TMDL formátumban

Ha engedélyezve van a TMDL Előzetes verziójú funkció, a projekt mentésekor a szemantikai modell egy \definitionnevű TMDL-mappaként lesz mentve a szemantikai modell mappájában:

Képernyőkép a szemantikai modell mappájában található definíciós mappáról.

További információ a TMDL-mappastruktúráról.

Meglévő PBIP átalakítása TMDL-vé

Ha már rendelkezik TMSL-t használó PBIP-sel szemantikai modellformátumként, az alábbiak szerint konvertálhatja TMDL-vé:

  1. Nyissa meg a PBIP-t a Power BI Desktopban.

  2. Győződjön meg arról, hogy az előnézeti funkció engedélyezve van.

  3. Mentse a projektet. Megjelenik egy üzenet, amely arra kéri, hogy frissítsen a TMDL-re.

  4. Válassza a Frissítés lehetőséget.

    Fontos

    A TMDL-re való frissítés után nem tud visszatérni a TMSL-re. Ha úgy gondolja, hogy vissza szeretne térni a TMSL-re, mentse először a PBIP-fájlok másolatát.

    Képernyőkép a szemantikai modell mappájának TMDL-re való frissítéséről.

A meglévő táblázatos modellszkriptnyelv (TMSL) fájl (model.bim) helyébe egy \definition mappa kerül, amely a szemantikai modell TMDL-ábrázolását tartalmazza.

A PBIP-projektek képernyőképe TMSL-mappákkal és TMDL-mappákkal.

Ha a Jelenlegi formátum megőrzése lehetőséget választja, az Asztal nem kéri újra a frissítést.

TMDL-fájlok külső módosítása

A TMDL-fájlok jobb olvasásához és szerkesztéséhez telepítse a TMDL – Visual Studio Marketplace Microsoft VS Code bővítményt.

Nyissa meg a PBIP mappát a VS Code használatával, és keresse meg a szemantikai modelldefiníciós mappát.

Képernyőkép egy szemantikai modelldefiníciós mappáról a VS Code-ban.

A Power BI Desktop nem ismeri a projektfájlok más eszközök által végzett módosításait. Ezért ha a Power BI Desktopon kívül módosítja a fájlok megnyitását, újra kell indítania a módosításokat, hogy megjelenjenek a Power BI Desktopban.

A Power BI Desktopon kívüli támogatott írási műveletekről itt tájékozódhat.

TMDL-hibák

Ha érvénytelen módosításokat végez a TMDL-fájlokon, a Power BI Desktop hibát jelez a megnyitáskor a hiba helyével:

Érvénytelen fájl hibaüzenetének képernyőképe.

Kapcsolódó tartalom

  • Last updated on