Verwalten eines Arbeitsbereichs mit Git (Vorschau)

Dieser Artikel führt Sie durch die folgenden grundlegenden Aufgaben im Git-Integrationstool von Microsoft Fabric:

• Herstellen einer Verbindung mit einem Git-Repository
• Committen von Änderungen
• Aus Git aktualisieren
• Trennen eines Arbeitsbereichs von Git

Es wird empfohlen, die Übersicht über die Git-Integration zu lesen, bevor Sie beginnen.

Wichtig

Dieses Feature befindet sich in der Vorschau.

Voraussetzungen

Um Git in Ihren Microsoft Fabric-Arbeitsbereich zu integrieren, müssen die folgenden Voraussetzungen sowohl in Azure DevOps als auch in Fabric erfüllt sein.

Voraussetzungen für Azure DevOps

• Aktives Azure-Konto, für das dieselben Benutzer*innen registriert sind, die auch den Fabric-Arbeitsbereich verwenden Erstellen Sie ein kostenloses Konto.
• Zugriff auf ein vorhandenes Repository

Voraussetzungen für Fabric

Für den Zugriff auf das Git-Integrationsfeature benötigen Sie eine der folgenden Komponenten:

• Power BI Premium-Lizenz: Eine Power BI Premium-Lizenz unterstützt nur alle Power BI-Elemente.
• Fabric-Kapazität: Eine Fabric-Kapazität ist erforderlich, um alle unterstützten Fabric-Elemente verwenden zu können.

Darüber hinaus muss der Administrator Ihrer Organisation den Mandantenwechsel von Fabric-Elementen über das Verwaltungsportal aktivieren.

Verbinden eines Arbeitsbereichs mit einem Azure-Repository

Ein Arbeitsbereich kann nur von Arbeitsbereichsadministrator*innen mit einem Azure-Repository verbunden werden. Sobald die Verbindung jedoch hergestellt wurde, kann jeder mit der entsprechenden Berechtigung im Arbeitsbereich arbeiten. Wenn Sie nicht über Administratorberechtigungen verfügen, bitten Sie Ihre Administrator*innen um Hilfe beim Herstellen einer Verbindung. Führen Sie die folgenden Schritte aus, um einen Arbeitsbereich mit einem Azure-Repository zu verbinden:

1. Melden Sie sich bei Power BI an, und navigieren Sie zu dem Arbeitsbereich, mit dem Sie eine Verbindung herstellen möchten.

2. Wechseln Sie zu Arbeitsbereichseinstellungen.

   

   Hinweis

   Wenn das Symbol für die Arbeitsbereichseinstellungen nicht angezeigt wird, wählen Sie die Auslassungspunkte (drei Punkte) und dann „Arbeitsbereichseinstellungen“ aus.

3. Wählen Sie Git-Integration aus. Sie werden automatisch bei dem Azure Repos-Konto angemeldet, bei dem der Microsoft Entra-Benutzer in Fabric registriert ist.

   

4. Geben Sie im Dropdownmenü die folgenden Details zu dem Branch an, mit dem Sie eine Verbindung herstellen möchten:

   Hinweis

   Sie können einen Arbeitsbereich immer nur mit einem Branch und einem Ordner verbinden.

   • Organisation
   • Projekt
   • Git-Repository
   • Branch: Wählen Sie im Dropdownmenü einen Branch aus, oder klicken Sie auf + Neuer Branch, um einen neuen zu erstellen. Sie können jeweils nur mit einem Branch eine Verbindung herstellen.)
   • Ordner: Wählen Sie einen vorhandenen Ordner im Branch aus, oder geben Sie einen Namen ein, um einen neuen Ordner zu erstellen. Wenn Sie keinen Ordner auswählen, werden Inhalte im Stammordner erstellt. Sie können jeweils nur mit einem Ordner eine Verbindung herstellen.)

5. Wählen Sie Verbinden und synchronisieren aus.

Wenn bei der ersten Synchronisierung entweder der Arbeitsbereich oder der Git-Branch leer ist, wird der Inhalt vom nicht leeren Speicherort in den leeren kopiert. Wenn sowohl der Arbeitsbereich als auch der Git-Branch über Inhalte verfügen, werden Sie gefragt, in welche Richtung die Synchronisierung erfolgen soll. Weitere Informationen zu dieser ersten Synchronisierung finden Sie unter Verbinden und Synchronisieren.

Nachdem Sie eine Verbindung hergestellt haben, zeigt der Arbeitsbereich Informationen zur Quellcodeverwaltung an, die es Benutzer*innen ermöglicht, den verbundenen Branch, den Status jedes Elements im Branch und den Zeitpunkt der letzten Synchronisierung anzuzeigen.

Um Ihren Arbeitsbereich mit dem Git-Branch zu synchronisieren, committen Sie alle Änderungen, die Sie im Arbeitsbereich vornehmen, an den Git-Branch, und aktualisieren Sie Ihren Arbeitsbereich, wenn jemand neue Commits für den Git-Branch erstellt.

Committen von Änderungen an Git

Nachdem Sie erfolgreich eine Verbindung mit einem Git-Ordner hergestellt haben, bearbeiten Sie Ihren Arbeitsbereich wie gewohnt. Alle Änderungen, die Sie speichern, werden nur im Arbeitsbereich gespeichert. Wenn Sie bereit sind, können Sie Ihre Änderungen an den Git-Branch committen, oder Sie können die Änderungen rückgängig machen und die Elemente in den vorherigen Status versetzen. Informieren Sie sich weiter über Commits.

Committen an Git

Führen Sie die folgenden Schritte aus, um Ihre Änderungen an den Git-Branch zu committen:

1. Wechseln Sie zum Arbeitsbereich.

2. Wählen Sie das Symbol für die Quellcodeverwaltung aus. Dieses Symbol zeigt die Anzahl der nicht committeten Änderungen an.

3. Wählen Sie im Bereich Quellcodeverwaltung die Registerkarte Änderungen aus. Es wird eine Liste mit allen von Ihnen geänderten Elementen und einem Symbol angezeigt, das angibt, ob das Element neu ist, geändert wurde, einen Konflikt aufweist oder gelöscht wurde.

4. Wählen Sie die Elemente aus, die Sie committen möchten. Um alle Elemente auszuwählen, aktivieren Sie das obere Kontrollkästchen.

5. Fügen Sie im Feld einen Kommentar hinzu. Wenn Sie keinen Kommentar hinzufügen, wird automatisch eine Standardnachricht hinzugefügt.

6. Klicken Sie auf Commit.

   

Nachdem die Änderungen committet wurden, werden die committeten Elemente aus der Liste entfernt, und der Arbeitsbereich verweist auf den neuen Commit, mit dem er synchronisiert wird.

Nachdem der Commit erfolgreich abgeschlossen wurde, ändert sich der Status der ausgewählten Elemente von Nicht committet in Synchronisiert.

Rückgängigmachen gespeicherter Änderungen

Wenn Sie Änderungen nach dem Speichern nicht an Git committen möchten, können Sie sie rückgängig machen und diese Elemente wieder in den vorherigen Status versetzen. Führen Sie die folgenden Schritte aus, um Ihre Änderungen rückgängig zu machen:

1. Wechseln Sie zum Arbeitsbereich.

2. Wählen Sie die Schaltfläche Quellcodeverwaltung aus. Diese Schaltfläche zeigt auch die Anzahl der nicht committeten Änderungen an.

3. Wählen Sie im Bereich Quellcodeverwaltung die Registerkarte Änderungen aus. Es wird eine Liste mit allen von Ihnen geänderten Elementen und einem Symbol angezeigt, das angibt, ob das geänderte Element neu ist, geändert wurde, einen Konflikt aufweist oder gelöscht wurde.

4. Wählen Sie die Änderungen aus, die Sie rückgängig machen möchten.

5. Wählen Sie Rückgängig aus.

   

6. Wählen Sie zur Bestätigung erneut Rückgängig machen aus.

   

Die ausgewählten Elemente in Ihrem Arbeitsbereich werden in den Status versetzt, den sie zum Zeitpunkt der letzten Synchronisierung des Arbeitsbereichs aufgewiesen haben.

Wichtig

Wenn Sie ein Element löschen und dann die Änderungen rückgängig machen, wird das Element neu erstellt, und einige der Metadaten gehen möglicherweise verloren. Beispielsweise werden die Vertraulichkeitsbezeichnungen nicht beibehalten und sollten zurückgesetzt werden, und die Besitzer*innen des Elements werden auf die aktuellen Benutzer*innen festgelegt.

Aktualisieren des Arbeitsbereichs über Git

Jedes Mal, wenn eine neue Änderung an den verbundenen Git-Branch committet wird, wird eine Benachrichtigung im entsprechenden Arbeitsbereich angezeigt. Verwenden Sie den Bereich Quellcodeverwaltung, um die neuesten Änderungen, Merges oder Wiederherstellungen in den Arbeitsbereich zu pullen und Liveelemente zu aktualisieren. Informieren Sie sich weiter über Aktualisierungen.

Führen Sie die folgenden Schritte aus, um einen Arbeitsbereich zu aktualisieren:

1. Wechseln Sie zum Arbeitsbereich.
2. Wählen Sie das Symbol für die Quellcodeverwaltung aus.
3. Wählen Sie im Bereich Quellcodeverwaltung die Registerkarte Aktualisierungen aus. Es wird eine Liste mit allen Elementen angezeigt, die seit der letzten Aktualisierung im Branch geändert wurden.
4. Wählen Sie Alle aktualisieren aus.

Nach der erfolgreichen Aktualisierung wird die Liste der Elemente entfernt, und der Arbeitsbereich verweist auf den neuen Commit, mit dem er synchronisiert wird.

Nachdem die Aktualisierung erfolgreich abgeschlossen wurde, ändert sich der Status der Elemente in Synchronisiert.

Trennen eines Arbeitsbereichs von Git

Nur Arbeitsbereichsadministrator*innen können einen Arbeitsbereich von einem Azure-Repository trennen. Wenn Sie nicht über Administratorberechtigungen verfügen, bitten Sie Ihre Administrator*innen um Hilfe beim Löschen einer Verbindung. Wenn Sie Administrator*in sind und Ihr Repository trennen möchten, führen Sie die folgenden Schritte aus:

1. Wechseln Sie zu Arbeitsbereichseinstellungen.

2. Wählen Sie Git-Integration aus

3. Wählen Sie Arbeitsbereich trennen aus.

   

4. Wählen Sie zur Bestätigung erneut Trennen aus.

   

Berechtigungen

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. Eine ausführlichere Erläuterung der Berechtigungen finden Sie unter Berechtigungen.

Überlegungen und Einschränkungen

• Während des Commitvorgangs an Git löscht der Fabric-Dienst alle Dateien im Elementordner, die nicht Teil der Elementdefinition sind. Nicht verknüpfte Dateien, die sich nicht in einem Elementordner 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.

• Wenn Sie Probleme mit diesen Aktionen haben, stellen Sie sicher, dass Sie die Einschränkungen des Git-Integrationsfeatures kennen.

Zugehöriger Inhalt

• Grundlegendes zum Git-Integrationsprozess
• Verwalten von Git-Branches
• Bewährte Methoden für die Lebenszyklusverwaltung