Semantikmodellordner eines Power BI Desktop-Projekts
Artikel
Wichtig
Power BI Desktop-Projekte befinden sich derzeit in der Vorschau.
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:
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.json
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.
Enthält Einstellungen des Semantikmodelleditors, die als Teil der Definition des Semantikmodells für die benutzerübergreifende und umgebungsübergreifende Verwendung gespeichert sind.
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 eine cache.abf vorhanden ist, lädt Power BI Desktop die Daten und überschreibt die Modelldefinition mit dem Inhalt in model.bim.
.pbi\unappliedChanges.json
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 anwenden auswählen, überschreibt Power BI Desktop die Abfragen in model.bim mit den Abfragen von unappliedChanges.json. Wenn Sie Abfragen in model.bim außerhalb von Power BI Desktop bearbeitet haben und eine frühere unappliedChanges.json-Datei vorhanden ist, gehen Ihre Änderungen verloren und werden durch die Abfragen in der unappliedChanges.json-Datei 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 an den Entwicklungsbranch committen, der als Sicherung dient und Ihre Arbeit anderen Teammitgliedern 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.
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.
Enthält Diagrammmetadaten, die die Struktur des Semantikmodells definieren, das dem Bericht zugeordnet ist. Während der VORSCHAU unterstützt diese Datei keine externe Bearbeitung.
Warnungsplattform beizubehalten.
Fabric-Plattformdatei, die Eigenschaften enthält, die für das Herstellen und Verwalten der Verbindung zwischen Fabric-Elementen und Git unerlässlich sind.
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.
Das Speichern als Power BI-Projekt im TMDL-Format befindet sich derzeit in der Vorschau. Bevor Sie die Funktion verwenden, müssen Sie sie zuerst unter „Previewfunktionen“ aktivieren:
Wechseln Sie zu Datei > Optionen und Einstellungen > Optionen > Previewfunktionen, und aktivieren Sie das Kontrollkästchen neben Semantikmodell im TMDL-Format speichern.
Speichern als Projekt im TMDL-Format
Wenn die Previewfunktion „TMDL-Format“ aktiviert ist, wird Ihr Semantikmodell beim Speichern eines Projekts als TMDL-Ordner mit dem Namen \definition innerhalb des Semantikmodellordners gespeichert:
Wenn Sie bereits über ein PBIP im TMSL-Format als Format des Semantikmodells verfügen, können Sie es wie folgt in TMDL konvertieren:
Öffnen Sie das PBIP in Power BI Desktop.
Stellen Sie sicher, dass die Previewfunktion aktiviert ist.
Speichern Sie das Projekt. Es wird eine Eingabeaufforderung angezeigt, in der Sie aufgefordert werden, ein Upgrade auf TMDL durchzuführen.
Wählen Sie Upgrade aus.
Wichtig
Nachdem Sie ein Upgrade auf TMDL durchgeführt haben, können Sie nicht mehr zu TMSL zurückkehren. Wenn Sie der Meinung sind, dass Sie zu TMSL zurückkehren möchten, speichern Sie zuerst eine Kopie Ihrer PBIP-Dateien.
Die vorhandene Tabular Model Scripting Language(TMSL)-Datei (model.bim) wird durch einen \definition-Ordner ersetzt, der die TMDL-Datei des Semantikmodells enthält.
Wenn Sie Aktuelles Format beibehalten auswählen, fordert der Desktop nicht erneut zur Durchführung eines Upgrades auf.
Öffnen Sie den PBIP-Ordner mithilfe von VS Code, und navigieren Sie zum Semantikmodelldefinitionsordner.
Power BI Desktop erkennt keine Änderungen an Projektdateien, die von anderen Tools vorgenommen wurden. Wenn Sie daher Änderungen an offenen Dateien außerhalb von Power BI Desktop vornehmen, müssen Sie einen Neustart durchführen, damit diese Änderungen in Power BI Desktop angezeigt werden.
Informationen zu unterstützten Schreibvorgängen außerhalb von Power BI Desktop finden Sie hier.
TMDL-Fehler
Wenn an den TMDL-Dateien ungültige Änderungen vorgenommen werden, löst Power BI Desktop einen Fehler beim Öffnen aus, wobei die Position des Fehlers angezeigt wird:
TMDL-Überlegungen und -Einschränkungen
Während der Public Preview exportiert die Git-Integration in Fabric das Semantikmodell weiterhin standardmäßig im TMSL-Format. Wenn das semantische Modell jedoch mit der Git-Integration für Fabric im TMDL-Format in Fabric importiert wird, verwendet die Git-Integration für Fabric das TMDL-Format, um die Definition des semantischen Modells in Git zu exportieren, wenn Änderungen des semantischen Modells im Dienst vorliegen.
Wichtig
Wenn Sie Ihr semantisches Modell mit einer anderen Importmethode importieren, z. B. der Power BI Desktop-Veröffentlichung, wechselt die Git-Integration für Fabric zurück zum TMSL-Standardformat.
Das Erstellen von Berichten auf Unternehmensniveau erfordert mehr als nur das Verknüpfen von Daten. Grundwissen zu semantischen Modellen und Strategien für die Skalierung und Lebenszyklusverwaltung sind für eine erfolgreiche Unternehmensimplementierung entscheidend. Dieser Lernpfad hilft Ihnen bei der Vorbereitung auf die „Fabric Analytics Engineer“-Zertifizierung.
Erfahren Sie mehr über die Methoden und Best Practices, die den geschäftlichen und technischen Anforderungen für die Modellierung, Visualisierung und Analyse von Daten mit Microsoft Power BI entsprechen.
Erfahren Sie, wie Sie die TMDL-Ansicht verwenden, um semantische Modellmetadaten in einem visuellen Format in Power BI Desktop anzuzeigen und zu verwenden.
Erfahren Sie mehr über die Git-Integration in Power BI Desktop-Projekte und optimieren Sie Ihre Entwicklungsprozesse, die Quellcodeverwaltung und die Zusammenarbeit mit Git-Repositorys.
