Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel werden die Dateien und Unterordner im Semantikmodellordner eines Microsoft Power BI Desktop-Projekts beschrieben. Die hier aufgeführten Dateien und Unterordner stellen ein Power BI-Semantikmodell dar. Abhängig von Ihrem Projekt kann der Semantikmodellordner Folgendes umfassen:
- .pbi\
- DAXQueries\-Ordner
- TMDLScripts\-Ordner
- definition\ folder3
- model.bim2
- diagramLayout.json
- .Plattform
- definition.pbism1
1 – Diese Datei ist erforderlich.
2 – Diese Datei ist beim Speichern im TMSL-Format erforderlich.
3 – Diese Datei ist beim Speichern im TMDL-Format erforderlich.
Nicht jeder Semantikmodellorder eines Projekts enthält alle hier beschriebenen Dateien und Unterordner.
Semantikmodelldateien
.pbi\localSettings.jsauf
Enthält Einstellungen des Semantikmodells, die nur für die aktuellen Benutzenden und den Computer gelten. Sie sollte in gitIgnore oder anderen Quellcodeverwaltungsausschlüssen enthalten sein. Standardmäßig ignoriert Git diese Datei.
Weitere Informationen finden Sie im Schemadokument zu localSettings.json.
.pbi\editorSettings.jsauf
Enthält Einstellungen des Semantikmodelleditors, die als Teil der Definition des Semantikmodells für die benutzerübergreifende und umgebungsübergreifende Verwendung gespeichert sind.
Weitere Informationen finden Sie im Schemadokument zu editorSettings.json.
.pbi\cache.abf
Eine ABF-Datei (Analysis Services Backup), die eine lokale zwischengespeicherte Kopie des Modells und der Daten zum Zeitpunkt der letzten Bearbeitung enthält. Sie sollte in gitIgnore oder anderen Quellcodeverwaltungsausschlüssen enthalten sein. Standardmäßig ignoriert Git diese Datei.
Power BI Desktop kann ein Projekt ohne die Datei „cache.abf“ öffnen. In diesem Fall wird der mit einem Modell verbundene Bericht mit der gesamten Definition, aber ohne Daten geöffnet. Wenn ein cache.abf vorhanden ist, lädt Power BI Desktop die Daten und überschreibt die Modelldefinition mit den Semantikmodellmetadaten im Projekt.
PBI-\unappliedChanges.jsauf
Mit Power BI Desktop können Sie Änderungen speichern, die im Transformationsdaten-Editor (Power Query) vorgenommen wurden, ohne diese Änderungen zuerst auf das Datenmodell anzuwenden.
Wenn Sie Später anwenden auswählen, werden die nicht angewendeten Änderungen in der Datei unappliedChanges.json gespeichert. Wenn sich ausstehende Änderungen in der UnappliedChanges-Datei befinden, fordert Power BI Desktop Sie auf, diese ausstehenden Änderungen anzuwenden oder zu verwerfen:
Wenn Sie "Änderungen übernehmen" auswählen, überschreibt Power BI Desktop die Abfragen in semantischen Modellmetadaten mit den Abfragen aus unappliedChanges.json. Wenn Sie Abfragen außerhalb von Power BI Desktop bearbeitet haben und eine vorherige unappliedChanges.json Datei vorhanden ist, gehen Ihre Änderungen verloren und werden durch die Abfragen in unappliedChanges.json ersetzt, wenn diese Änderungen angewendet werden.
Die unappliedChanges.json-Datei wird automatisch in die Definition des Semantikmodells integriert und standardmäßig in Git gespeichert. Auf diese Weise können Sie Ihre laufende Arbeit in den Entwicklungszweig übertragen, was als Sicherung dient und Ihre Arbeit für andere Teammitglieder zugänglich macht. Sie haben jedoch die Möglichkeit, diese Datei aus der Git-Nachverfolgung auszuschließen, um zu verhindern, dass sich nicht abgeschlossene Abfragevorgänge auf andere Entwickelnde auswirken.
Weitere Informationen finden Sie im Schemadokument zu unappliedChanges.json .
definition.pbism
Enthält die Gesamtdefinition eines Semantikmodells und die Haupteinstellungen.
Diese Datei gibt auch die unterstützten Definitionsformate für semantische Modelle über die Eigenschaft „Version“ an.
| Version | Unterstützte Formate |
|---|---|
| 1,0 | Die Definition des semantischen Modells muss als TMSL in der Datei „model.bim“ gespeichert werden. |
| 4.0 oder höher | Die Definition des semantischen Modells kann als TMSL (model.bim file) oder TMDL (\definition folder) gespeichert werden. |
Weitere Informationen finden Sie im Schemadokument zu definition.pbism.
model.bim
Diese Datei ist nur verfügbar, wenn das Power BI-Projekt im TMSL-Format gespeichert wird. Enthält eine Datenbankobjektdefinition des Projektmodells im Tabular Model Scripting Language(TMSL)-Format.
definition\ folder
Dieser Ordner ist nur verfügbar, wenn das Power BI-Projekt im TMDL-Format gespeichert wird. Sie ersetzt die model.bim-Datei.
Dieser Ordner enthält eine TmDL-Datenbankobjektdefinition (Tabular Model Definition Language)des Projektmodells.
diagramLayout.json
Enthält Diagrammmetadaten, die die Struktur des Semantikmodells definieren, das dem Bericht zugeordnet ist. Sie können diese Datei nicht extern bearbeiten.
Plattform
Fabric-Plattformdatei, die Eigenschaften enthält, die für das Herstellen und Verwalten der Verbindung zwischen Fabric-Elementen und Git unerlässlich sind.
Weitere Informationen finden Sie unter Git-Integration automatisch generierte Systemdateien.
DAXQueries\Ordner
Enthält eine Datei für jede DAX-Abfrageansicht-Registerkarte, die als [Tab name].dax DAX-Datei gespeichert ist.
.pbi\daxQueries.json
Enthält DAX-Abfrageansichts-Editoreinstellungen wie DefaultTab oder Tabulatorreihenfolge.
TMDLScripts\-Ordner
Enthält eine Datei für jede TMDL-Ansichtsskript-Registerkarte, die als [Tab name].tmdl TMDL-Datei gespeichert ist.
.pbi\tmdlscripts.json
Enthält TMDL-Ansichts-Editor-Einstellungen wie DefaultTab oder Tab-Reihenfolge.
TMDL-Format
Mit dem Ziel, eine bessere Quellcodeverwaltung und Co-Entwicklung zu ermöglichen, können Sie Ihre Power BI-Projektdateien (PBIP) im Tabular Model Definition Language(TMDL)-Format als Dateiformat des Semantikmodells speichern.
Im Gegensatz zum Tabular Model Scripting Language(TMSL)-Format wurde das TMDL-Format von Grund auf so entwickelt, dass es benutzerfreundlich ist und nicht nur die Lesbarkeit, sondern auch die einfache Bearbeitung in jedem Text-Editor erleichtert. Dies stellt eine erhebliche Verbesserung der Quellcodeverwaltung und dergemeinsamen Entwicklung dar.
Anstelle einer großen JSON-Datei wie Tabular Model Scripting Language (TMSL) verfügt TMDL über eine Ordnerstruktur mit separaten Dateien für jede Tabelle, Perspektive, Rolle und Kultur. Dies erleichtert das Arbeiten mit anderen und das Verständnis der Struktur des Semantikmodells durch einfaches Betrachten des Ordners und der Dateien. Letztendlich führt dies zu einer großartigen Quellcodeverwaltung und Co-Entwicklung beim Umgang mit Git Diff- und Git Merge-Konflikten.
Weitere Informationen zu TMDL finden Sie hier.
Vornehmen externer Änderungen an TMDL-Dateien
Sie können TMDL-Dateien in Visual Studio Code oder einem anderen externen Tool bearbeiten, während das Projekt in Power BI Desktop geöffnet bleibt. Um eine bessere TMDL-Bearbeitung zu erzielen, installieren Sie die TMDL-Erweiterung für Visual Studio Code.
Bevor Sie die Dateien extern bearbeiten, speichern Sie alle Änderungen in Power BI Desktop. Öffnen Sie den PBIP-Ordner in VS Code, navigieren Sie zum Semantikmodellordner definition , und speichern Sie ihre TMDL-Änderungen. Power BI Desktop erkennt die gespeicherten Änderungen und zeigt das Banner "Externe Änderungen anwenden" an. Wählen Sie "Externe Änderungen anwenden" aus, um das semantische Modell neu zu laden, ohne das Projekt zu schließen und erneut zu öffnen.
Wenn Power BI Desktop nicht gespeicherte Änderungen aufweist, werden Sie gewarnt, dass das Anwenden der externen Änderungen sie überschreibt. Die vollständigen Workflows und Einschränkungen finden Sie unter "Bearbeiten von PBIP-Dateien außerhalb Power BI Desktops".
Unterstützte Schreibvorgänge außerhalb Power BI Desktops finden Sie unter Modellerstellung.
TMDL-Fehler
Wenn eine TMDL-Bearbeitung ungültig ist, zeigt Power BI Desktop einen Fehler an, wenn Sie die externen Änderungen anwenden oder das Projekt öffnen. Der Fehler identifiziert den Speicherort, den Sie beheben müssen, bevor Power BI Desktop das aktualisierte Semantikmodell laden kann:
