Verwalten von Power BI Inhalten in der Versionssteuerung
Wiederverwendbare Ressourcen bieten Ihnen konsistente Grundlagen, aber ohne Versionsverwaltung können Sie nicht nachverfolgen, was geändert wurde, wer sie geändert hat oder wann. Power BI Desktopprojekte und Git-Integration in Fabric professionelle Quellcodeverwaltung in Ihren Analyseworkflow bringen.
Power BI-Desktopprojekte
Ein Power BI Desktopprojekt (.pbip) speichert Den Bericht und das semantische Modell als Nur-Text-Dateien in einer Ordnerstruktur anstelle einer einzelnen binären .pbixDatei. Der Projektordner enthält zwei Hauptunterordner:
- <name>. SemanticModel/ enthält die Semantikmodelldefinition im TMDL-Format (Tabular Model Definition Language). TMDL speichert jede Tabelle, Messung und Beziehung als separate lesbare Textdatei.
-
<name>. Report/ enthält die Berichtsdefinition im Format Power BI Report (
.pbir). Eine.pbirDatei ist ein JSON-Dokument, in dem die Seiten, visuellen Elemente und das Layout des Berichts als strukturierter Text gespeichert werden. Dieser Dateityp ermöglicht die Versionsverwaltung, im Gegensatz zur.pbixDatei, die als Binärdaten gespeichert ist.
Da jede Definition eine Textdatei ist, können Sie Standard-Diff-Tools verwenden, um genau zu sehen, was zwischen Versionen geändert wurde. Eine umbenannte Spalte, eine geänderte DAX-Maßnahme oder eine hinzugefügte Beziehung wird als Klartext sichtbar anstelle eines binären Unterschieds angezeigt.
Um als project zu speichern, wechseln Sie zu File>Speichern als in Power BI Desktop, und wählen Sie Power BI Project (PBIP) als Dateityp aus. Power BI Desktop erstellt die Ordnerstruktur und eine .gitignoreDatei, die Cache- und lokale Einstellungsdateien aus der Versionssteuerung ausschließt.
Hinweis
Power BI Desktop-Projektdateien befinden sich derzeit in der Vorschau. Aktivieren Sie das Feature in File>Options und Einstellungen>Options>Preview-Features>Power BI Project (PBIP)-Speicheroption.
Das Projektformat unterstützt auch die programmgesteuerte Bearbeitung. Da die Semantikmodelldefinition TMDL-Textdateien verwendet, können Sie Skripts oder Tools verwenden, um Batchaktualisierungen vorzunehmen. Beispielsweise können Sie jeder Maßnahme im Modell eine Beschreibung hinzufügen, indem Sie die TMDL-Dateien direkt ändern und dann die Batchänderung über Git übernehmen.
Aktivieren der Git-Integration für einen Arbeitsbereich
Die Git-Integration verbindet einen Fabric Arbeitsbereich mit einem Git-Repository in Azure DevOps oder GitHub. Änderungen an Arbeitsbereichselementen werden bidirektional zwischen dem Arbeitsbereich und dem Repository synchronisiert. Diese Integration auf Arbeitsbereichsebene bedeutet, dass Sie alle Elemente in einem Arbeitsbereich über eine einzelne Verbindung versionskontrollieren können.
So richten Sie die Git-Integration ein:
- Öffnen Sie Ihren Arbeitsbereich im Fabric-Portal.
- Wählen Sie Arbeitsbereichseinstellungen>Git-Integration aus.
- Stellen Sie eine Verbindung mit Ihrem Git-Anbieter (Azure DevOps oder GitHub) her.
- Wählen Sie das Repository, den Branch und den Ordner für die Zuordnung.
- Schließen Sie die anfängliche Synchronisierung ab, um den Arbeitsbereich mit dem Repository auszurichten.
Nachdem die Verbindung hergestellt wurde, zeigt der Arbeitsbereich Git-Statusindikatoren für jedes Element an. Elemente, die sich vom Repository unterscheiden, zeigen ein Änderungssymbol an. Elemente, die dem Repository entsprechen, zeigen einen synchronisierten Status an.
Hinweis
Die Git-Integration unterstützt viele Fabric Elementtypen, die über Power BI hinausgehen, darunter Notizbücher, Pipelines, Seehäuser und Lagerhäuser. Sie können einen gesamten Arbeitsbereich mit gemischten Inhalten über eine einzelne Git-Verbindung versionskontrollieren.
Arbeiten mit einem mit Git verbundenen Arbeitsbereich
Sobald der Arbeitsbereich verbunden ist, arbeiten Sie in einem Zyklus der Bearbeitung, des Commits und der Synchronisierung.
- Commit: Wenn Sie Änderungen an Elementen im Arbeitsbereich vornehmen, wählen Sie Versionsverwaltung, um ausstehende Änderungen zu prüfen. Wählen Sie die zu übernehmenden Elemente aus, stellen Sie eine beschreibende Commit-Nachricht bereit, und speichern Sie Ihre Änderungen im Git-Repository.
- Update: Wenn das Repository neuere Änderungen von anderen Teammitgliedern aufweist, wählen Sie "Alle aktualisieren " aus, um diese Änderungen in den Arbeitsbereich zu übertragen. Dadurch wird der Arbeitsbereich mit dem neuesten Repositorystatus synchronisiert.
- Branches: Sie können den Arbeitsbereich zu einem anderen Branch für Entwicklung oder Tests wechseln. Jede Verzweigung stellt eine unabhängige Entwicklungslinie dar. Erstellen Sie Funktions Branches für experimentelle Änderungen, die sich bis zur Prüfung nicht auf den Main Branch auswirken sollen.
- Konflikte: Wenn dasselbe Element sowohl im Arbeitsbereich als auch im Repository seit der letzten Synchronisierung geändert wurde, meldet Git einen Konflikt. Sie lösen den Konflikt, indem Sie auswählen, welche Version die Änderungen manuell beibehalten oder zusammenführen soll.
Kombinieren von Projekten und Git-Integration
Power BI Desktopprojekte und Fabric Git-Integration ergänzen sich in einem Teamworkflow:
-
Lokale Entwicklung: Autoren speichern ihre Arbeit als
.pbipProjekte auf ihrem lokalen Computer mithilfe von Power BI Desktop zum Erstellen und zur Iteration. -
Commit to Git: Autoren committen
.pbipDateien in das gemeinsame Git-Repository. Das textbasierte Format macht Codeüberprüfungen praktisch, da Prüfer genau sehen können, welche Measures, Spalten oder visuellen Elemente geändert wurden. - Workspace sync: Der Fabric Arbeitsbereich wird mit dem Repository synchronisiert, sodass veröffentlichte Inhalte die neuesten Commits widerspiegeln.
Dieser Workflow bietet Ihnen die Vorteile der lokalen Entwicklung (schnellere Iteration, Offlinearbeit) in Kombination mit zentralisiertem Versionsverlauf und Teamzusammenarbeit über Git.
| Workflowschritt | Werkzeug | Zweck |
|---|---|---|
| Autor und Iteration | Power BI Desktop (.pbip) | Lokale Entwicklung mit lesbaren Textdateien |
| Änderungen nachverfolgen | Git (Azure DevOps oder GitHub) | Versionsverlauf, Verzweigung, Pullanforderungen |
| In einem Dienst veröffentlichen | Arbeitsbereichs-Synchronisierung für Fabric mit Git | Bereitstellen von zugesicherten Inhalten im Arbeitsbereich |
Tipp
Verwenden Sie Pull Requests als Qualitätskontrollen. Es muss mindestens ein Gutachter die Änderungen genehmigen, bevor sie mit dem Hauptzweig zusammengeführt werden. Dadurch wird ein Überprüfungsschritt zwischen Entwicklung und Bereitstellung hinzugefügt, um Probleme abzufangen, bevor sie den Arbeitsbereich erreichen.
Mit wiederverwendbaren Ressourcen unter Versionsverwaltung ist die Entwicklungsphase abgeschlossen. Als Nächstes wechseln Sie zur Validierungsphase – überprüfen und verifizieren Ihre Modelle programmgesteuert durch den XMLA-Endpunkt.