Was ist die Microsoft Fabric-Git-Integration?
In diesem Artikel wird Entwickelnden erläutert, wie sie die Git-Versionskontrolle in das Microsoft Fabric Application Lifecycle Management-Tool (ALM) integrieren.
Hinweis
Einige der Elemente für die Git-Integration befinden sich in der Vorschauphase. Weitere Informationen finden Sie in der Liste der unterstützten Elemente.
Die Git-Integration in Microsoft Fabric ermöglicht es Entwicklern, ihre Entwicklungsprozesse, Tools und bewährten Methoden direkt in die Fabric-Plattform zu integrieren. Sie ermöglicht Entwicklern, die in Fabric entwickeln, Folgendes:
- Sichern und Versionieren ihrer Arbeit
- Wiederherstellen vorheriger Phasen nach Bedarf
- Mit anderen zusammenarbeiten oder alleine arbeiten mit Git-Branches
- Wenden Sie die Funktionen vertrauter Quellcodeverwaltungstools an, um Fabric-Elemente zu verwalten
Die Integration mit der Versionskontrolle erfolgt auf Arbeitsbereichsebene. Entwickler können Elemente, die sie in einem Arbeitsbereich entwickeln, in einem einzigen Prozess versionieren und haben dabei vollen Einblick in alle ihre Elemente. Derzeit werden nur einige Elemente unterstützt, aber die Liste der unterstützten Elemente wächst.
Informieren Sie sich über Versionskontrolle und Git, um sicherzustellen, dass Sie mit den grundlegenden Git-Konzepten vertraut sind.
Erfahren Sie mehr über den Git-Integrationsprozess.
Erfahren Sie mehr über die beste Methode zum Verwalten Ihrer Git-Branches.
Datenschutzinformationen
Bevor Sie die Git-Integration aktivieren, sollten Sie sich über die folgenden möglichen Datenschutzerklärungen im Klaren sein:
- Datenschutzerklärung von Microsoft
- Azure DevOps Services Übersicht über den Datenschutz
- GitHub Datenschutz-Vereinbarung
Unterstützte Git-Anbieter
Die folgenden Git-Anbieter werden unterstützt:
- Git in Azure Repos mit demselben Mandanten wie dem Fabric-Mandanten
- GitHub
- GitHub Enterprise
Unterstützte Elemente
Die folgenden Elemente werden derzeit unterstützt:
- Datenpipelines (Vorschau)
- Dataflows gen2 (Vorschau)
- EventHouse (Vorschau)
- EventStream (Vorschau)
- Lakehouse (Vorschau)
- Eventhouse- und KQL-Datenbank(Vorschau)
- Notebooks
- Paginierte Berichte (Vorschau)
- Reflex (Vorschau)
- Berichte (mit Ausnahme von Berichten, die mit semantischen Modellen verbunden sind, die in Azure Analysis Services oder SQL Server Analysis Services gehostet werden, und Berichten, die von Power BI Desktop exportiert werden und von in MyWorkspace gehosteten semantischen Modellen abhängen) (Vorschau)
- Semantische Modelle (außer Pushdatasets, Liveverbindungen zum Analysis Services-Modell v1) (Vorschau)
- Spark-Auftragsdefinitionen (Vorschau)
- Spark-Umgebung (Vorschau)
- SQL-Datenbank (Vorschau)
- Warehouses (Vorschau)
Wenn der Arbeitsbereich oder das Git-Verzeichnis nicht unterstützte Elemente enthält, kann er trotzdem weiterhin verbunden sein. Die nicht unterstützten Elemente werden jedoch ignoriert. Sie werden nicht gespeichert oder synchronisiert, aber auch nicht gelöscht. Sie werden im Bereich der Versionskontrolle angezeigt, aber Sie können sie nicht committen oder aktualisieren.
Überlegungen und Einschränkungen
Allgemeine Einschränkungen bei der Git-Integration
- Die Authentifizierungsmethode in Fabric muss mindestens so stark sein wie die Authentifizierungsmethode für Git. Wenn Git beispielsweise eine Multi-Faktor-Authentifizierung erfordert, muss Fabric auch eine Multi-Faktor-Authentifizierung erfordern.
- Power BI-Datasets, die mit Analysis Services verbunden sind, werden derzeit nicht unterstützt.
- Arbeitsbereiche mit installierten Vorlagen-Apps können nicht mit Git verbunden werden.
- Sovereign Clouds werden nicht unterstützt.
- Das Azure DevOps-Konto muss für den Benutzer registriert werden, der auch den Fabric-Arbeitsbereich verwendet.
- Der Mandantenadministrator muss geoübergreifende Exporte aktivieren, wenn sich der Arbeitsbereich und das Git Repository in zwei verschiedenen geografischen Regionen befinden.
- Wenn Ihre Organisation den bedingten Zugriff eingerichtet hat, stellen Sie sicher, dass im Power BI-Dienst wie erwartet dieselben Bedingungen für die Authentifizierung festgelegt sind.
- Das Größenlimit für ein Commit beträgt 125 MB.
GitHub Enterprise-Einschränkungen
Einige GitHub Enterprise-Einstellungen werden nicht unterstützt. Zum Beispiel:
- Liste zugelassener IP-Adressen
- Privates Netzwerk
- Benutzerdefinierte Domänen
Einschränkungen bei Arbeitsbereichen
- Nur der Arbeitsbereichs-Admin ist in der Lage, Verbindungen mit dem Git-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. - Die Struktur des Arbeitsbereichordners wird nicht im Git-Repository wiedergegeben. Arbeitsbereichselemente in Ordnern werden in das Stammverzeichnis exportiert.
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.
- Git-Ordner verwenden die logische ID (GUID) als Präfix vor dem Typ, wenn der Anzeigename des Elements wie folgt lautet:
- mehr als 256 Zeichen enthält,
- Endet mit . oder einem Leerzeichen
- Beinhaltet eines der nachstehenden Zeichen: " / : < > \ * ? |
Verzweigungseinschränkungen
- Verzweigung erfordert Berechtigungen, die in der Berechtigungstabelle aufgeführt sind.
- Für diese Aktion muss eine verfügbare Kapazität vorhanden sein.
- Alle Arbeitsbereichs- und Zweignamensbeschränkungen gelten auch bei der Verzweigung in einen neuen Arbeitsbereich.
- Beim Verzweigen wird ein neuer Arbeitsbereich erstellt. Die Einstellungen aus dem ursprünglichen Arbeitsbereich werden nicht kopiert. Passen Sie alle Einstellungen oder Definitionen an, um sicherzustellen, dass der neue Arbeitsbereich den Richtlinien Ihrer Organisation entspricht.
- Nur unterstützte Git-Elemente sind im neuen Arbeitsbereich verfügbar.
- In der Liste der verwandten Verzweigungen werden nur Verzweigungen und Arbeitsbereiche angezeigt, die Sie zum Anzeigen berechtigt sind.
- Die Git-Integration muss aktiviert sein.
Einschränkungen bei Synchronisierungen und Commits
- 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. Nicht unterstützte Artikel im Ordner werden ignoriert.
- Das Duplizieren von Namen ist 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.
- Während des Commit-Vorgangs an Git löscht der Fabric-Dienst alle Dateien im Artikel-Ordner, die nicht Teil der Artikel-Definition sind. Nicht verknüpfte Dateien, die sich nicht in einem Artikel-Ordner befinden, werden nicht gelöscht.
- Nach dem Committen von Änderungen werden Sie möglicherweise einige unerwartete Änderungen an dem Element feststellen, die Sie nicht vorgenommen haben. Diese Änderungen sind semantisch unbedeutend und können aus verschiedenen Gründen auftreten. Beispiel:
- Manuelles Ändern der Elementdefinitionsdatei. Diese Änderungen sind gültig, können sich aber von denen unterscheiden, die über die Editors vorgenommen werden. Wenn Sie beispielsweise eine Semantikmodellspalte in Git umbenennen und diese Änderung in den Arbeitsbereich importieren, wird die BIM-Datei beim nächsten Commit von Änderungen an das Semantikmodell als geändert registriert, und die geänderte Spalte wird an das Ende des
columns
-Arrays gepusht. Dies liegt daran, dass die AS-Engine, die die BIM-Dateien generiert, umbenannte Spalten an das Ende des Arrays pusht. Diese Änderung wirkt sich nicht auf die Funktionsweise des Elements aus. - Committen einer Datei, die CRLF-Zeilenumbrüche verwendet. Der Dienst verwendet Zeilenvorschub-Zeilenumbrüche (Line Feed, LF). Wenn im Git-Repository Elementdateien mit CRLF-Zeilenumbrüchen vorhanden waren, werden diese Dateien beim Committen über den Dienst in LFs geändert. Wenn Sie beispielsweise einen Bericht auf dem Desktop öffnen, speichern Sie das PBIP-Projekt, und laden Sie es mithilfe von CRLF in Git hoch.
- Manuelles Ändern der Elementdefinitionsdatei. Diese Änderungen sind gültig, können sich aber von denen unterscheiden, die über die Editors vorgenommen werden. Wenn Sie beispielsweise eine Semantikmodellspalte in Git umbenennen und diese Änderung in den Arbeitsbereich importieren, wird die BIM-Datei beim nächsten Commit von Änderungen an das Semantikmodell als geändert registriert, und die geänderte Spalte wird an das Ende des
- Beim Aktualisieren eines Semantikmodells mithilfe der API für erweiterte Aktualisierungen wird nach jeder Aktualisierung ein Git-Diff erstellt.