Verwenden Sie den Versionsverlauf des semantischen Modells (Vorschau)

2025-06-16

Power BI konfiguriert automatisch den Versionsverlauf des semantischen Modells für im Web bearbeitete semantische Modelle. Mit dem Versionsverlauf können Self-Service-Benutzer bei der Bearbeitung ihrer semantischen Modelle im Web die wichtigsten Fehler wiederherstellen. Verwenden Sie für die vollständige Quellcodeverwaltung und Unterstützung weiterer Versionen Git-Integration, die in Kombination mit dem Versionsverlauf für dasselbe Semantikmodell verwendet werden können.

Öffnen Sie den Versionsverlaufsbereich

Sie können frühere Versionen eines semantischen Modells mithilfe eines Office-ähnlichen Versionsverlaufsbereichs anzeigen. Das Öffnen des Bereichs für den Versionsverlauf kann an mehreren Orten und auf verschiedene Weisen erfolgen, wobei alle dasselbe Ergebnis haben:

Wählen Sie in der Inhaltsliste des Arbeitsbereichs Weitere Optionen (...) für das semantische Modell aus, und wählen Sie dann Versionsverlaufaus.
Wählen Sie in der Inhaltsliste des OneLake-Katalogs Weitere Optionen (...) für das semantische Modell aus, und wählen Sie dann Versionsverlaufaus.
Wählen Sie auf der Detailseite des semantischen Modells Datei und dann Versionsverlauf aus.
Wählen Sie beim Bearbeiten eines semantischen Modells im Web Datei und dann Versionsverlaufaus.
Wenn Sie ein semantisches Modell im Web bearbeiten, wählen Sie die Titelleiste für das semantische Modell aus, und wählen Sie dann Versionsverlaufaus.

Ansicht des Versionsverlaufsfensters

Im Versionsverlaufsbereich können Sie bis zu fünf Versionen pro semantischem Modell anzeigen. Jede der Versionen im Bereich der Versionshistorie speichert die Metadaten und Daten des Semantikmodells. Jede im Bereich aufgeführte Version zeigt die folgenden Informationen zur Version an:

Der Zeitstempel der letzten Änderung, die am semantischen Modell vorgenommen wurde, das in der Version erfasst wurde.
Der Name der Person, die die letzte Änderung am semantischen Modell vorgenommen hat, das in der Version erfasst wurde.
Eine Beschreibung für die Version, wenn sie zuvor von einem Benutzer beim manuellen Speichern der Version bereitgestellt wurde.

Eine Version im Versionsverlauf speichern

Versionen eines semantischen Modells werden nach dem Öffnen im Bearbeitungsmodus im Web oder beim Öffnen eines Direct Lake-Modells für die Livebearbeitung in Power BI Desktoperfasst.

Jedes semantische Modell, das den Versionsverlauf unterstützt, kann bis zu fünf Versionen gespeichert haben. Eine Version wird immer dann im Versionsverlauf gespeichert, wenn eine der folgenden Aktionen ausgeführt wird:

Wenn Sie eine Version manuell im Versionsverlauf speichern. Wählen Sie beim Bearbeiten eines semantischen Modells im Web Datei und dann Im Versionsverlauf speichern aus.

Wenn Sie eine Version manuell speichern, können Sie optional eine Textbeschreibung angeben, um diese Version später im Versionsverlaufsbereich zu identifizieren.

Die Beschreibung wird mit der entsprechenden Version im Versionsverlaufsbereich angezeigt.
Wenn Sie eine PBIX-Datei aus Power BI Desktop veröffentlichen oder eine PBIX-Datei im Web hochladen, wird eine Version des semantischen Modells vor dem Veröffentlichen/Hochladen erfasst. Durch die automatische Erfassung der Version wird sichergestellt, dass Sie, wenn Sie beim Veröffentlichen/Hochladen versehentlich die im Web vorgenommenen Änderungen überschreiben, das Modell in den Zustand oder die Version wiederherstellen können, bevor unbeabsichtigte Veröffentlichung/Upload erfolgt ist.
Wenn Sie Ihr semantisches Modell im Web im Bearbeitungsmodus öffnen, wird eine Version des semantischen Modells erfasst. Dadurch können Sie, falls Sie unerwünschte Änderungen während Ihrer Webbearbeitungssitzung vornehmen, das Modell auf den Zustand oder die Version zurücksetzen, der/die vor diesen Änderungen bestand.
Wenn Sie Ihr semantisches Modell aus dem Versionsverlauf auf eine frühere Version wiederherstellen, wird eine Version des Modells vor der Wiederherstellung gespeichert, sodass Sie den Zustand vor der Wiederherstellung wiederherstellen können, falls eine unerwünschte Version ausgewählt wurde.

Wiederherstellen einer früheren Version

Um ein Semantikmodell in einer früheren Version wiederherzustellen, wählen Sie im Versionsverlaufsbereich Wiederherstellen im Kontextmenü der Version aus, die Sie wiederherstellen möchten.

Screenshot, der zeigt, wie eine frühere Version eines semantischen Modells aus dem Versionsverlaufsbereich wiederhergestellt wird.

Der Versionsverlaufsbereich zeigt auch einen Eintrag für die aktuelle Version des Modells an. Sie können ihre aktuelle Version nicht wiederherstellen, daher bietet das Kontextmenü für Ihre aktuelle Version die Möglichkeit, das semantische Modell im Web zu öffnen.

Screenshot mit dem Kontextmenü einer aktuellen Semantikmodellversion aus dem Versionsverlaufsbereich.

Anzeigen von Überwachungsprotokollen und Aktivitätsereignissen

Power BI-Administratoren können das Microsoft 365 Admin Center verwenden, um Überwachungsvorgänge zum Wiederherstellen und Speichern von Versionen im Versionsverlauf des semantischen Modells zu überwachen. Die folgenden Tabellen zeigen, welche Überwachungsvorgänge für den Versionsverlauf des semantischen Modells unterstützt werden:

Freundlicher Name	Vorgangsname	Hinweise
Ein Modell in einer früheren Version wiederhergestellt	Vorherige Version für PowerBI-Modell wiederherstellen	Ein Benutzer stellt ein Power BI-Semantikmodell in einer früheren Version wieder her, die im Versionsverlauf gespeichert wurde.
Speichern einer neuen Version im Versionsverlauf für ein Modell in Power BI	SpeichereEineNeueVersionFürPowerBI-Modell	Eine neue Version wird für den Versionsverlauf eines Power BI-Semantikmodells gespeichert.

Weitere Informationen zum Zugreifen auf Überwachungsprotokolle finden Sie im Artikel Zugreifen auf Ihre Überwachungsprotokolle Artikel.

Kapazitätsauslastung und Berichterstellung

Sie können beobachten, wie sich die Wiederherstellung in einer früheren Version mit Versionsverlauf auf Ihre Power BI Premium-Kapazitäten auswirkt, indem Sie die Premium-Metrik-App verwenden. Der Kapazitätseffekt kann mithilfe der folgenden Operationüberwacht werden.

Vorgang	Beschreibung	Arbeitsbelastung	Typ
Schreiben der Webmodellierung	Ein Datenmodell-Schreibvorgang in der Benutzeroberfläche der Semantikmodell-Webmodellierung	Semantische Modelle	Interaktiv

Für den Speicher, der zum Erfassen von Versionen im Versionsverlauf des semantischen Modells verwendet wird, fallen keine zusätzlichen Kosten für Ihre Modelle an.

Anforderungen und Berechtigungen

Benutzer müssen über Write und Build Berechtigung für das semantische Modell verfügen, um den Versionsverlauf anzuzeigen und zu verwenden. Weitere Informationen finden Sie im Artikel mit den Berechtigungen.
Das Feature "Versionsverlauf" ist für Benutzer mit einer kostenlosen Lizenz nicht verfügbar.

Überlegungen und Einschränkungen

Der Versionsverlauf des semantischen Modells befindet sich derzeit in der Vorschauversion. Beachten Sie Folgendes:

Bis zu fünf Versionen werden pro Modell gespeichert. Das Speichern von Versionen nach Erreichen des Grenzwerts von fünf Versionen überschreibt die älteste Version im Versionsverlauf.
Das Wiederherstellen von Versionen, die älter als 14 Tage sind, wird nicht unterstützt. Beachten Sie, dass diese Einschränkung derzeit nicht vom Produkt erzwungen wird.
Der Versionsverlauf wird für semantische Modelle, die in My Workspacegespeichert sind, nicht unterstützt.
Das semantische Modell muss zuerst im Web geöffnet oder für die Direct Lake-Livebearbeitung in Power BI Desktop geöffnet werden, bevor die Versionen für das Modell erfasst werden.
Sie können keine Änderungen am semantischen Modell vornehmen, wenn das Modell in einer früheren Version wiederhergestellt wird.
Sie können eine Version im Versionsverlauf eines semantischen Modells nicht löschen.
Der Versionsverlauf des semantischen Modells unterliegt den gleichen Einschränkungen wie beim Bearbeiten von Datenmodellen im Power BI-Dienst.
Der Versionsverlauf wird nicht für semantische Modelle erfasst, die noch nicht auf erweiterte Metadatenformataktualisiert wurden. Wenn ein Modell mit dem alten Metadatenformat über ein Modell im erweiterten Metadatenformat veröffentlicht wird, werden alle zuvor erfassten Semantikmodellversionen für dieses Modell gelöscht.
Durch das Verschieben eines Modells zwischen den Kapazitäten wird der Versionsverlauf gelöscht.
Sie können nicht auf Versionen im Versionsverlauf des semantischen Modells außerhalb des Versionsverlaufsbereichs im Web zugreifen. Verwenden Sie für die vollständige Quellcodeverwaltung mit größerer Flexibilität und Unterstützung für weitere Versionen Git-Integration, die in Kombination mit dem Versionsverlauf für dasselbe Semantikmodell verwendet werden können.
Die Daten in Ihrem semantischen Modell werden nach der Wiederherstellung in einer früheren Version möglicherweise veraltet. Um sicherzustellen, dass Sie über die neuesten Daten verfügen, führen Sie eine Aktualisierung nach dem Ausführen einer Wiederherstellung durch. Das Aktualisierungsverhalten kann je nach Speichermodi variieren. Beispielsweise werden Direct Lake-Modelle, die mit automatischen Updates konfiguriert sind, nach einer Wiederherstellung automatisch mit den neuesten Daten aktualisiert, ohne dass Sie eine Aktualisierung manuell initiieren müssen.
Während eines Failovers bleiben Lesevorgänge wie das Anzeigen des Versionsverlaufs des semantischen Modells verfügbar. Vorgänge, die Power BI-Inhalte ändern, z. B. das Speichern einer neuen Version oder das Wiederherstellen einer früheren Version im Versionsverlauf des semantischen Modells, werden jedoch nicht unterstützt, wenn Power BI sich im Failovermodus befindet.

Überlegungen zum Speicherformat des großen Semantikmodells

Für das semantische Modell muss das Speicherformat für große semantische Modelle aktiviert sein. Semantische Modelle werden beim ersten Öffnen im Bearbeitungsmodus im Web oder beim Öffnen eines Direct Lake-Modells für die Livebearbeitung in Desktop automatisch in ein Speicherformat für große semantische Modelle konvertiert. Wenn ein semantisches Modell mit versionen, die im Versionsverlauf erfasst wurden, in den Modelleinstellungen das große Speicherformat für das semantische Modell deaktiviert hat, wird der gesamte Versionsverlauf für dieses Modell gelöscht. Eine Warnung in den Semantikmodelleinstellungen informiert Sie über diese Auswirkung, bevor Sie die Änderung vornehmen: Screenshot mit einer Warnung zum Löschen des Versionsverlaufs.

Ein Semantikmodell kann nicht in das speicherformat des großen Semantikmodells konvertiert werden, wenn die Speicherbeschränkungen überschritten werden. Um diese Speicherbeschränkungen zu beheben, können Sie entweder das Modell auf einer Premium-Kapazitäts-SKU hosten, die die erforderliche Speichergröße für das Modell unterstützt, oder die Größe des Modells verringern.

Dieser Artikel enthält Informationen zur Vorschau für semantische Modellversionen. Weitere Informationen zur Datenmodellierung in Power BI finden Sie in den folgenden Ressourcen: