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

A Power BI Desktop projekt szemantikai modellmappája

  • Cikk

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

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

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 model.bim tartalmával.

.pbi\unappliedChanges.json

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.

A lekérdezésmódosítás alkalmazása párbeszédpanelt ábrázoló kép.

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

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-projektet TMSL formátumban menti. Táblázatos modellszkriptnyelvet (TMSL) tartalmaz a projektmodell adatbázis-objektumdefiníciója .

definition\ folder

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 egy táblázatos modelldefiníciós nyelvet (TMDL)A projektmodell adatbázis-objektumdefiníciójá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.

.peron

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.

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 barátságos 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 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.

Mentés projektként A TMDL használatával

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.

TMDL-szempontok és korlátozások

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.

Kapcsolódó tartalom