Grundlegende Konzepte der Git-Integration

In diesem Artikel werden grundlegende Git-Konzepte und die Integration von Git in Ihren Microsoft Fabric-Arbeitsbereich erläutert.

Wichtig

Dieses Feature befindet sich in Vorschau.

Berechtigungen

• Um die Git-Integration verwenden zu können, muss der Administrator Ihrer Organisation diese aktivieren werden.
• Wenn sich der Arbeitsbereich und das Repository in zwei verschiedenen Regionen befinden, muss der Mandantenadministrator regionsübergreifenden Export aktivieren.
• Welche Aktionen Sie für einen Arbeitsbereich ausführen können, hängt von den Berechtigungen ab, über die Sie sowohl im Arbeitsbereich als auch in Azure DevOps verfügen.

Azure DevOps-Berechtigungen

Die folgende Liste zeigt, welche Möglichkeiten verschiedene Arbeitsbereichsrollen abhängig von ihren Azure DevOps-Berechtigungen bieten:

• Administrator: Kann beliebige Vorgänge im Arbeitsbereich ausführen. Diese werden nur durch die Azure DevOps-Rolle eingeschränkt.
• Mitglied/Mitwirkender: Sobald sie eine Verbindung mit einem Arbeitsbereich herstellen, kann ein Mitglied/Mitwirkender je nach Azure DevOps-Rolle Änderungen committen und aktualisieren. Bei Aktionen im Zusammenhang mit der Arbeitsbereichsverbindung (z. B. Verbinden, Trennen oder Wechseln zwischen Branches) benötigen Sie Unterstützung von einem Administrator.
• Betrachter: Kann keine Aktionen ausführen. Der Betrachter kann keine Git-bezogenen Informationen im Arbeitsbereich sehen.

Für allgemeine Vorgänge erforderliche Berechtigungen

In der folgenden Tabelle werden die Berechtigungen beschrieben, die zum Ausführen verschiedener allgemeiner Vorgänge erforderlich sind:

Vorgang	Arbeitsbereichsrolle	Git-Berechtigungen
Arbeitsbereich mit Git-Repository verbinden	Administrator	Read=Allow
Arbeitsbereich mit Git-Repository synchronisieren	Administrator	Read=Allow
Arbeitsbereich von Git-Repository trennen	Administrator	Keine Berechtigungen erforderlich
Branch im Arbeitsbereich wechseln (oder beliebige Änderung an der Verbindungseinstellung)	Administrator	Read=Allow (in Zielrepository/-verzeichnis/-branch)
Git-Verbindungsdetails anzeigen	Administrator, Mitglied, Mitwirkender	Read oder keine
„Git-Status“ des Arbeitsbereichs anzeigen	Administrator, Mitglied, Mitwirkender	Read=Allow
Aus Git aktualisieren	Alle folgenden Rollen: Mitwirkender im Arbeitsbereich (WRITE-Berechtigung für alle Elemente) Besitzer des Elements (wenn der Mandantenwechsel Updates für Nichtbesitzer blockiert) BUILD für externe Abhängigkeiten (sofern zutreffend)	Read=Allow
Arbeitsbereichsänderungen in Git committen	Alle folgenden Rollen: Mitwirkender im Arbeitsbereich (WRITE-Berechtigung für alle Elemente) Besitzer des Elements (wenn der Mandantenwechsel Updates für Nichtbesitzer blockiert) BUILD für externe Abhängigkeiten (sofern zutreffend)	Read=Allow Contribute=Allow Branchrichtlinie sollte direkte Commits zulassen
Neuen Git-Branch in Fabric erstellen	Administrator	Role=Write Create branch=Allow

Verbinden und Synchronisieren

Ein Arbeitsbereich kann nur von einem Arbeitsbereichsadministrator mit Azure Repos verbunden werden. Sobald die Verbindung jedoch hergestellt wurde, kann jeder mit entsprechenden Berechtigungen im Arbeitsbereich arbeiten. Wenn Sie kein Administrator sind, bitten Sie Ihren Administrator um Hilfe beim Herstellen einer Verbindung.

Wenn Sie einen Arbeitsbereich mit Git verbinden, wird Fabric zwischen den beiden Orten synchronisiert, sodass sie über dieselben Inhalte verfügen. Wenn bei dieser anfänglichen Synchronisierung entweder der Arbeitsbereich oder der Git-Branch leer ist, während der andere Inhalte aufweist, wird der Inhalt vom nicht leeren Ort an den leeren kopiert. Wenn sowohl der Arbeitsbereich als auch der Git-Branch über Inhalte verfügen, müssen Sie entscheiden, in welche Richtung die Synchronisierung erfolgen soll.

• Wenn Sie Ihren Arbeitsbereich in den Git-Branch committen, werden alle unterstützten Arbeitsbereichsinhalte nach Git exportiert und die aktuellen Git-Inhalte überschrieben.
• Wenn Sie den Arbeitsbereich mit den Inhalten aus Git aktualisieren, werden die Arbeitsbereichsinhalte überschrieben und gehen verloren. Während ein Git-Branch immer auf eine frühere Phase zurückgesetzt werden kann, ist das bei einem Arbeitsbereich nicht möglich. Daher werden Sie bei Auswahl dieser Option aufgefordert, den Vorgang zu bestätigen.

Sie müssen auswählen, welche Inhalte synchronisiert werden sollen. Andernfalls können Sie die Arbeit nicht fortsetzen:

Befehl „git status“

Nachdem Sie eine Verbindung hergestellt haben, wird im Arbeitsbereich eine Spalte mit dem Git-Status angezeigt, in der der Synchronisierungsstatus jedes Elements im Arbeitsbereich im Verhältnis zu den Elementen im Remotebranch angegeben ist.

Jedes Element weist eine der folgenden Statusangaben auf:

• Synchronisiert (das Element ist im Arbeitsbereich und im Git-Branch identisch)
• Konflikt (das Element wurde sowohl im Arbeitsbereich als auch im Git-Branch geändert)
• Nicht unterstütztes Element
• Ausgecheckte Änderungen im Arbeitsbereich
• Update aus Git erforderlich
• Das Element ist an beiden Stellen identisch, muss jedoch auf den letzten Commit aktualisiert werden

Informationen zur Synchronisierung

Solange Sie verbunden sind, werden die folgenden Informationen am unteren Bildschirmrand angezeigt:

• Verbundener Branch
• Zeitpunkt der letzten Synchronisierung
• Link zum letzten Commit, mit dem der Arbeitsbereich synchronisiert wurde

Commits und Updates

Quellcodeverwaltungsbereich

Oben im Bildschirm befindet sich das Quellcodeverwaltungssymbol. Darin wird angezeigt, wie viele Elemente sich zwischen dem Arbeitsbereich und dem Git-Branch unterscheiden. Wenn der Arbeitsbereich mit dem Git-Branch synchronisiert wird, wird im Quellcodeverwaltungssymbol 0 angezeigt.

Wenn Änderungen am Arbeitsbereich oder am Git-Branch vorgenommen werden, wird im Quellcodeverwaltungssymbol angezeigt, wie viele Elemente unterschiedlich sind. Wählen Sie das Quellcodeverwaltungssymbol aus, um den Quellcodeverwaltungsbereich zu öffnen.

Im Bereich Quellcodeverwaltung auf der Registerkarte Änderungen wird die Anzahl der Elemente angezeigt, die im Arbeitsbereich geändert wurden und in Git committet werden müssen. Auf der Registerkarte Updates wird die Anzahl der Elemente angezeigt, die im Git-Branch geändert wurden und im Arbeitsbereich aktualisiert werden müssen.

Auf jeder Registerkarte werden die geänderten Elemente mit einem Symbol aufgeführt, das den Status angibt:

• neu
• geändert
• gelöscht
• Konflikt

Commit

• Wenn mehr als ein Element committet werden muss, können Sie auswählen, welche Elemente in den Git-Branch committet werden sollen.
• Wenn Updates für den Git-Branch vorgenommen wurden, werden Commits deaktiviert, bis Sie Ihren Arbeitsbereich aktualisieren.

Aktualisieren

• Im Gegensatz zu commit und undo wird mit dem Befehl update immer der gesamte Branch aktualisiert und eine Synchronisierung mit dem letzten Commit ausgeführt. Sie können keine bestimmten Elemente für das Update auswählen.
• Wenn Änderungen im Arbeitsbereich und im Git-Branch für dasselbe Element vorgenommen wurden, werden Updates deaktiviert, bis der Konflikt behoben ist.

Weitere Informationen zum Ausführen von Commits und Updates finden Sie hier. Weitere Informationen zum Updateprozess und zum Beheben von Konflikten finden Sie hier.

Überlegungen und Einschränkungen

Allgemeine Einschränkungen

• Das Azure DevOps-Konto muss für den Benutzer registriert werden, der auch den Fabric-Arbeitsbereich verwendet.
• Die Authentifizierungsmethode in Power BI muss mindestens so stark sein wie die Authentifizierungsmethode für Azure DevOps. Wenn Azure DevOps beispielsweise eine Multi-Faktor-Authentifizierung erfordert, muss Power BI auch eine Multi-Faktor-Authentifizierung erfordern.
• Direkte Abfragen und zusammengesetzte Modelle für Power BI-Datasets und Analysis Services werden derzeit nicht unterstützt.
• DirectLake-Semantikmodelle werden derzeit nicht unterstützt.
• Beim Aktualisieren eines Semantikmodells mithilfe der API für erweiterte Aktualisierungen wird nach jeder Aktualisierung ein Git-Diff erstellt.
• Die Struktur des Arbeitsbereichordners wird nicht im Git-Repository wiedergegeben. Arbeitsbereichselemente in Ordnern werden in das Stammverzeichnis exportiert.

Einschränkungen bei Arbeitsbereichen

• Nur der Arbeitsbereichsadministrator ist in der Lage, Verbindungen mit dem Azure-Repository zu verwalten, also z. B. Verbindungen herzustellen bzw. zu trennen oder einen Branch hinzuzufügen.
  Sobald die Verbindung hergestellt wurde, kann jeder mit der geeigneten Berechtigung im Arbeitsbereich arbeiten.

Einschränkungen bei Branches und Ordnern

• Ein Branchname darf maximal 244 Zeichen lang sein.

• Die maximale Länge des vollständigen Pfads für Dateinamen beträgt 250 Zeichen. Längere Namen verursachen einen Fehler.

• Die maximale Dateigröße beträgt 25 MB.

• Sie können einen Bericht/ein Dataset nicht als PBIX-Datei aus dem Dienst herunterladen, nachdem Sie diese mit der Git-Integration bereitgestellt haben.

• Wenn der Anzeigename des Elements

  • mehr als 256 Zeichen enthält,
  • mit .’ oder einem Leerzeichen endet,
  • eines der Zeichen ", /, :, <, >, \\, *, ? oder | enthält,

  Die logische ID (Guid) wird beim Benennen des Ordners in Git dem Typ als Präfix vorangestellt.

Einschränkungen bei Synchronisierungen und Commits

• Das Größenlimit für einen Commit beträgt 125 MB.
• Die Synchronisierung kann jeweils nur in eine Richtung ausgeführt werden. Commits und Updates können nicht gleichzeitig ausgeführt werden.
• Vertraulichkeitsbezeichnungen werden nicht unterstützt, und das Exportieren von Elementen mit Vertraulichkeitsbezeichnungen ist möglicherweise deaktiviert. Um Elemente mit Vertraulichkeitsbezeichnungen ohne die Vertraulichkeitsbezeichnung zu committen, bitten Sie Ihren Administrator um Unterstützung.
• Funktioniert mit einer begrenzten Anzahl von Elementen. Wenn der Ordner nicht unterstützte Elemente enthält, werden diese ignoriert.
• Doppelte Namen sind nicht zulässig. Selbst wenn dies in Power BI unterstützt wird, schlägt die Aktion „update“, „commit“ oder „undo“ fehl.
• B2B wird nicht unterstützt.
• Konflikte werden teilweise in Git gelöst.

Zugehöriger Inhalt

• Verwalten von Branches
• Beheben von Fehlern und Konflikten