Freigeben über

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. Die Arbeitsbereichsstruktur, einschließlich Unterordner, wird im Git-Repository beibehalten.

Siehe die Liste der unterstützten Elemente.

Datenschutzinformationen

Bevor Sie die Git-Integration aktivieren, sollten Sie sich über die folgenden möglichen Datenschutzerklärungen im Klaren sein:

Unterstützte Git-Anbieter

Die folgenden Git-Anbieter werden unterstützt:

Unterstützte Elemente

Die folgenden Elemente unterstützen derzeit die Git-Integration:

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 Quellcodeverwaltungsbereich angezeigt, aber Sie können sie weder committen noch 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.
  • Wenn Sie eine Arbeitsbereichsidentität in einem Artefakt verwenden und auf Git commiten, kann sie (zurück zu einem Fabric-Arbeitsbereich) nur in einem Arbeitsbereich aktualisiert werden, der mit derselben Identität verbunden ist. Seien Sie vorsichtig, da sich dies auch auf Features wie Verzweigung auswirkt.
  • Untermodule werden nicht unterstützt.
  • Sovereign Clouds werden nicht unterstützt.
  • Das Azure DevOps-Konto muss für den Benutzer registriert werden, der auch den Fabric-Arbeitsbereich verwendet.
  • Azure DevOps wird nicht unterstützt, wenn die Richtlinienvalidierung für bedingten IP-Zugriff aktiviert ist.
  • Der Mandantenadministrator muss geoübergreifende Exporte aktivieren, wenn sich der Arbeitsbereich und das Git-Repository in zwei verschiedenen geografischen Regionen befinden.
  • Wenn Ihre Organisation bedingten Zugriff konfiguriert hat, stellen Sie sicher, dass der Power BI-Dienst die gleichen Bedingungen aufweist , die für die Authentifizierung wie erwartet festgelegt sind.
  • Das Größenlimit für ein Commit beträgt 125 MB.

GitHub Enterprise-Einschränkungen

Einige GitHub Enterprise-Versionen und -Einstellungen werden nicht unterstützt. Zum Beispiel:

  • GitHub Enterprise Cloud mit Datenresidenz (ghe.com)
  • GitHub Enterprise Server mit einer benutzerdefinierten Domäne wird nicht unterstützt, auch wenn die Instanz öffentlich zugänglich ist
  • Github Enterprise Server, gehostet in einem privaten Netzwerk
  • Liste zugelassener IP-Adressen

Einschränkungen des Arbeitsplatzes

  • Nur der Arbeitsbereichsadministrator kann die Verbindungen mit dem Git-Repository verwalten, z. B. Verbinden, Trennen oder Hinzufügen einer Verzweigung.
    Sobald eine Verbindung hergestellt wurde, kann jeder, der über die Berechtigung verfügt, im Arbeitsbereich arbeiten.
  • Arbeitsbereiche mit installierten Vorlagen-Apps können nicht mit Git verbunden werden.
  • MyWorkspace kann keine Verbindung mit einem Git-Anbieter herstellen.

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 Fehler.
  • Die maximale Dateigröße beträgt 25 MB.
  • Die Ordnerstruktur wird bis zu 10 Ebenen tief beibehalten.
  • Das Herunterladen eines Berichtes/Datasets als .pbix vom Dienst nach der Bereitstellung mit Git-Integration wird nicht empfohlen, da die Ergebnisse unzuverlässig sind. Wir empfehlen die Verwendung von PowerBI Desktop zum Herunterladen von Berichten/Datasets als PBIX.
  • Wenn der Anzeigename des Elements eines dieser Merkmale aufweist, wird der Git-Ordner in die logische ID (Globally Unique Identifier, GUID) und den entsprechenden Typ umbenannt:
  • Wenn Sie einen Arbeitsbereich mit Ordnern mit Git verbinden, müssen Sie Änderungen am Git-Repository übernehmen, wenn diese Ordnerstruktur anders ist.

Einschränkungen für Verzeichnisnamen

  • Der Name des Verzeichnisses, das eine Verbindung mit dem Git-Repository herstellt, hat die folgenden Benennungseinschränkungen:

    • Der Verzeichnisname kann nicht mit einem Leerzeichen oder einer Registerkarte beginnen oder enden.
    • Der Verzeichnisname darf keines der folgenden Zeichen enthalten: "/:<>\*|

  • Der Elementordner (der Ordner, der die Elementdateien enthält) darf keines der folgenden Zeichen enthalten: ":<>\*?|. Wenn Sie den Ordner in etwas umbenennen, das eines dieser Zeichen enthält, kann Git keine Verbindung mit dem Arbeitsbereich herstellen oder synchronisieren, und ein Fehler tritt auf.

Verzweigungseinschränkungen

  • Für das Verzweigen sind die Berechtigungen erforderlich, die in der Berechtigungstabelle aufgeführt sind.
  • Für diese Aktion muss eine verfügbare Kapazität vorhanden sein.
  • Alle Arbeitsbereichs- und Brachnamensbeschränkungen gelten auch bei Verzweigungen in einen neuen Arbeitsbereich.
  • Nur unterstützte Git-Elemente sind im neuen Arbeitsbereich verfügbar.
  • In der Liste der zugehörigen Branches werden nur Branches und Arbeitsbereiche angezeigt, die Sie sehen dürfen.
  • Die Git-Integration muss aktiviert sein.
  • Beim Verzweigen wird eine neue Verzweigung erstellt, und die Einstellungen aus der ursprünglichen Verzweigung werden nicht kopiert. Passen Sie alle Einstellungen oder Definitionen an, um sicherzustellen, dass das neue die Richtlinien Ihrer Organisation erfüllt.
  • Beim Wechseln zu einem vorhandenen Arbeitsbereich:
    • Der Zielarbeitsbereich muss eine Git-Verbindung unterstützen.
    • Der Benutzer muss ein Administrator des Zielarbeitsbereichs sein.
    • Der Zielarbeitsbereich muss über Kapazität verfügen.
    • Der Arbeitsbereich kann keine Vorlagen-Apps enthalten.
  • Beachten Sie, dass beim Verzweigen zu einem Arbeitsbereich alle Elemente, die nicht auf Git gespeichert sind, verloren gehen können. Es wird empfohlen, alle Elemente, die Sie beibehalten möchten, vor dem Verzweigen zu committen.

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 eingeschränkten Elementen. Nicht unterstützte Artikel im Ordner werden ignoriert.
  • Das Duplizieren von Namen ist nicht zulässig. Selbst wenn Power BI die Namensduplikation zulässt, schlägt die Aktion zum Aktualisieren, Committen oder Rückgängigmachen fehl.
  • B2B wird nicht unterstützt.
  • Die Konfliktlösung erfolgt teilweise in Git.
  • Während des Commit-vorgangs zu Git löscht der Fabric-Dienst Dateien innerhalb des Elementordners, die nicht Teil der Elementdefinition 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 Übernehmen von Änderungen am Semantikmodell als geändert registriert und die geänderte Spalte an die Rückseite des columns Arrays verschoben. Dies liegt daran, dass das AS-Modul, das die Bim-Dateien generiert, umbenannte Spalten an das Ende des Arrays verschiebt. 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 Sie Elementdateien im Git-Repository mit CRLF-Zeilenumbrüchen hatten, werden diese Dateien beim Commit aus dem Dienst in LF geändert. Wenn Sie beispielsweise einen Bericht auf dem Desktop öffnen, speichern Sie die Projektdatei (PBIP), und laden Sie ihn mit CRLF auf Git hoch.
  • Das Aktualisieren eines semantischen Modells mithilfe der erweiterten Aktualisierungs-API führt nach jeder Aktualisierung zu einem Git-Diff.

Zugehöriger Inhalt