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 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.
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.
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 model.bim tartalmával.
A Power BI Desktop segítségével anélkül mentheti az Adatátalakítás szerkesztőben (Power Query), hogy először alkalmazná ezeket a módosításokat az adatmodellre.
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:
Ha a Módosítások alkalmazása lehetőséget választja, a Power BI Desktop felülírja a model.bim lekérdezéseit a unappliedChanges.json lekérdezéseivel. Ha a Power BI Desktopon kívül szerkesztett lekérdezéseket a model.bim-ban, és egy korábbi unappliedChanges.json fájl található, a módosítások elvesznek, és a módosítások alkalmazásakor a unappliedChanges.json lekérdezései lecserélik őket.
A unappliedChanges.json fájl automatikusan bekerül a szemantikai modell definíciójába, és alapértelmezés szerint a Gitbe menti. 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.
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.
Ez a fájl csak akkor érhető el, ha a Power BI-projektet TMSL formátumban menti. Táblázatos modellszkriptnyelvet (TMSL) tartalmaz a projektmodell adatbázis-objektumdefiníciója .
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.
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.
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.
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.
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.
További információ a TMDL-ről itt.
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 engedélyeznie kell 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 TMDL formátumot használó Szemantikai modell áruház melletti jelölőnégyzetet.
Ha engedélyezve van a TMDL Előzetes verziójú funkció, a projekt mentésekor a szemantikai modell egy \definition nevű TMDL-mappaként lesz mentve a szemantikai modell mappájában:
További információ a TMDL-mappastruktúráról.
Ha már rendelkezik TMSL-t használó PBIP-sel szemantikai modellformátumként, az alábbiak szerint konvertálhatja TMDL-vé:
Nyissa meg a PBIP-t a Power BI Desktopban.
Győződjön meg arról, hogy az előnézeti funkció engedélyezve van.
Mentse a projektet. Megjelenik egy üzenet, amely arra kéri, hogy frissítsen a TMDL-re.
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.
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.
Ha a Jelenlegi formátum megőrzése lehetőséget választja, az Asztal nem kéri újra a frissítést.
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.
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.
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:
A nyilvános előzetes verzióban a Fabric Git Integration alapértelmezés szerint a TMSL használatával exportálja a szemantikai modellt. Ha azonban a szemantikai modellt Fabric Git Integration with TMDL formátummal importálja a Fabricbe, akkor a Fabric Git Integration TMDL formátummal exportálja a szemantikai modell definícióját a Gitbe, ha a szolgáltatásban szemantikai modellmódosítások történnek.
Fontos
Ha a szemantikai modellt bármilyen más importálási módszerrel(például Power BI Desktop Publish) importálja, a Fabric Git Integration visszaáll az alapértelmezett TMSL-formátumra.