Beginnen Sie mit der Git-Integration

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.

Voraussetzungen

Um Git in Ihren Microsoft Fabric Arbeitsbereich zu integrieren, müssen Sie die folgenden Voraussetzungen für Fabric und Git einrichten.

Voraussetzungen für Fabric

Um das Git-Integrationsfeature zu access, benötigen Sie eine Fabric-Kapazität. Eine Fabric-Kapazität ist erforderlich, um alle unterstützten Fabric-Elemente verwenden zu können. Falls Sie noch nicht darüber verfügen, können Sie sich für eine kostenlose Testversion registrieren. Kunden, die bereits über eine Power BI Premium-Kapazität verfügen, können diese Kapazität verwenden, beachten Sie jedoch, dass bestimmte Power BI-SKUs nur Power BI-Elemente unterstützen.

Darüber hinaus müssen die folgenden Mandantenoptionen über das Verwaltungsportal aktiviert werden:

• Benutzer können Fabric-Elemente erstellen – erforderlich, wenn Fabric-Artefakte verwendet werden
• Benutzer können Arbeitsbereichselemente mit ihren Git-Repositorys synchronisieren.
• Erstellen Sie Arbeitsbereiche (nur, wenn Sie eine Verzweigung zu einem neuen Arbeitsbereich durchführen möchten.)
• Benutzer können Arbeitsbereichselemente mit GitHub Repositorys synchronisieren: Nur für GitHub Benutzer

Diese Optionen können vom Mandantenadministrator, Kapazitätsadministrator oder Arbeitsbereichsadministrator abhängig von den Einstellungen Ihrer Organisation aktiviert werden.

Git-Voraussetzungen

Die Git-Integration wird derzeit für Azure DevOps und GitHub unterstützt. Um die Git-Integration in Ihren Fabric-Arbeitsbereich zu verwenden, benötigen Sie folgendes in Azure DevOps oder GitHub:

Azure DevOps

• Ein Azure DevOps-Konto, das für denselben Fabric-Benutzer registriert ist, wird unterstützt, auch wenn die Azure DevOps-Organisation sich in einem anderen Mandanten als dem Fabric-Mandanten befindet. Erstellen Sie ein kostenloses Konto.
• Access zu einem vorhandenen Repository.

GitHub

• Ein aktives GitHub Konto. Erstellen Sie ein GitHub-Konto.

• Einer der folgenden Personalzugriffstoken:

  • Ein feinkörniges Token (empfohlen) mit Inhalte Lese- und Schreibrecht unter den Berechtigungen des Repositorys:

    

    Um dieses Token mit GitHub Enterprise zu verwenden, folgen Sie these directions.

  • Ein GitHub-Classic-Token erstellen mit aktivierten Repo-Berechtigungen:

    

Arbeitsbereich mit einem Git-Repository verbinden

Herstellen einer Verbindung mit einem Git-Repository

Ein Arbeitsbereich kann nur vom Arbeitsbereichsadministrator mit einem Repository verbunden werden. Sobald die Verbindung jedoch hergestellt wurde, kann jeder mit der entsprechenden Berechtigung im Arbeitsbereich arbeiten. Wenn Sie kein Administrator sind, bitten Sie Ihren Administrator um Hilfe beim Herstellen einer Verbindung. Führen Sie die folgenden Schritte aus, um einen Arbeitsbereich mit einem Azure- oder GitHub-Repository zu verbinden:

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

2. Wechseln Sie zu Arbeitsbereichseinstellungen.

   

3. Wählen Sie Git-Integration aus.

4. Wählen Sie den gewünschten Git-Anbieter aus. Derzeit werden Azure DevOps und GitHub unterstützt.

Azure DevOps Connect

Wenn Sie Azure DevOps auswählen, wählen Sie Verbinden aus, um sich automatisch bei dem Azure Repos-Konto anzumelden, das für den Microsoft Entra-Benutzer registriert ist, der sich bei Fabric angemeldet hat.

Wenn Sie sich bereits mit einem anderen Konto bei der Azure von Fabric angemeldet haben, wählen Sie Ihr Konto aus der Liste aus, und wählen Sie Verbinden aus.

Wenn Sie sich zum ersten Mal bei Fabric anmelden oder ein neues Konto hinzufügen möchten, wählen Sie "Konto hinzufügen" aus.

Wenn sie zum ersten Mal eine Verbindung herstellt, müssen Sie Ihren Benutzer autorisieren. Geben Sie die folgenden Informationen ein:

• Anzeigename – muss für jeden Benutzer eindeutig sein
• Azure DevOps-URL – URL des Azure DevOps-Repositorys. DIE URL muss im Format https://dev.azure.com/{organization}/{project}/_git/{repository} oder https://{organization}.visualstudio.com/{project}/_git/{repo} sein.
• Authentifizierung – Sie können sich entweder mit OAuth2 oder einem Dienstprinzipal authentifizieren. Weitere Informationen finden Sie unter Azure DevOps – Git-Integration mit Dienstprinzipal

Nachdem Sie sich angemeldet haben, wählen Sie Connect aus, damit Fabric auf Ihr Konto zugreifen kann.

GitHub Connect

Wenn Sie GitHub auswählen, müssen Sie sich bei Ihrem GitHub Konto anmelden. Wenn Sie sich bereits bei GitHub angemeldet haben, wählen Sie Ihr Konto aus der Liste aus, und wählen Sie Verbinden aus.

Wenn Sie sich zum ersten Mal bei Fabric anmelden oder ein neues Konto hinzufügen möchten, wählen Sie "Konto hinzufügen" aus.

Wenn Sie zum ersten Mal eine Verbindung herstellen, müssen Sie Ihren GitHub-Benutzer autorisieren. Geben Sie die folgenden Informationen ein:

• Display-Name - muss für jeden GitHub Benutzer eindeutig sein.
• Persönlicher Zugangstoken - Ihr klassischer oder fein abgestufter persönlicher Zugangstoken
• Repository URL (optional für github.com, obligatorisch für ghe.com) – Wenn Sie keine URL eingeben, können Sie eine Verbindung mit einem beliebigen github.com Repository herstellen, mit dem Sie access haben. Wenn Sie eine URL eingeben, können Sie nur eine Verbindung mit diesem Repository herstellen.

Wählen Sie nach der Anmeldung Connect aus, damit Fabric Ihr GitHub Konto access kann.

Stellen Sie eine Verbindung zu einem Arbeitsbereich her.

Wenn der Arbeitsbereich bereits mit Azure DevOps/GitHub verbunden ist, folgen Sie den Anweisungen für Verbinden zu einem freigegebenen Arbeitsbereich.

Azure DevOps Branch-Verbindung

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

   • Organization
   • Project
   • 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 (Geben Sie den Namen eines vorhandenen Ordners ein, oder geben Sie einen Namen ein, um einen neuen Ordner zu erstellen. Wenn Sie den Ordnernamen leer lassen, werden Inhalte im Stammordner erstellt. Sie können jeweils nur eine Verbindung mit einem Ordner herstellen.)

Screenshot zur Azure-Verbindung.

GitHub Branch Connect

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

   • Repository-URL. Wenn Sie mit GitHub über ein bereichsbezogenes Token verbunden sind, wird die URL automatisch ausgefüllt, und Sie können nur eine Verbindung mit diesem Repository herstellen.
   • 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 (Geben Sie den Namen eines vorhandenen Ordners ein, oder geben Sie einen Namen ein, um einen neuen Ordner zu erstellen. Wenn Sie den Ordnernamen leer lassen, werden Inhalte im Stammordner erstellt. Sie können jeweils nur eine Verbindung mit einem Ordner herstellen.)

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 einpflegen, oder Sie können die Änderungen rückgängig machen und zum vorherigen Status zurückkehren.

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. Eine Liste wird mit allen elementen angezeigt, die Sie geändert haben, und ein Symbol, das angibt, ob das Element neu , geändert , Konflikt , gleiche Änderung oder gelöscht ist .

4. Wählen Sie die Elemente aus, die Sie übertragen 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.

Commit für eigenständige Verzweigung

Commit für einen eigenständigen Branch ist ein Git-Integrationsfeature, mit dem Sie einen neuen Branch erstellen und Ihre aktuellen Änderungen in einem einzigen Schritt committen können. Anders ausgedrückt: Anstatt sich auf die verbundene Verzweigung zu verpflichten, können Sie unterwegs abzweigen: Das System dreht eine neue Git-Verzweigung aus und speichert Ihre Arbeit dort, ohne dass Sie die ursprüngliche Verzweigung verlassen oder von Ihrer ursprünglichen Verzweigung wechseln müssen.

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. Eine Liste wird mit allen elementen angezeigt, die Sie geändert haben, und ein Symbol, das angibt, ob das Element neu , geändert , Konflikt , gleiche Änderung oder gelöscht ist .
4. Wählen Sie die Elemente aus, die Sie übertragen 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. Wählen Sie "Commit für neue Verzweigung übernehmen" aus.

Wichtig

Bedenken Sie dabei Folgendes:

• Die neu erstellte Branch wird nicht mit dem vorhandenen Arbeitsbereich verbunden sein.
• Die neu erstellte Branch basiert auf dem letzten Synchronisierungsstatus des aktuellen Arbeitsbereichs.
• Diese Funktionalität ist möglich, wenn eingehende Updates vorhanden sind – auch wenn der Standard-Commit deaktiviert ist.
• Der aktuelle Arbeitsbereichsstatus wird aufgrund dieses Commits nicht geändert und bleibt unverändert.

Rückgängigmachen gespeicherter Änderungen

Wenn Sie nach dem Speichern von Änderungen am Arbeitsbereich entscheiden, dass Sie diese Änderungen nicht auf Git übernehmen möchten, können Sie die Änderungen rückgängig machen und diese Elemente auf den vorherigen Status zurücksetzen. 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 übernommenen Änderungen an.

3. Wählen Sie Änderungen im Bereich Quellcodeverwaltung 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. Setzen Sie ein Häkchen in das Feld Ich bestätige, dass ich verstanden habe, dass Arbeitsbereichselemente möglicherweise gelöscht und nicht wiederhergestellt werden können und wählen Sie Rückgängig aus.

   

6. Wählen Sie zur Bestätigung erneut Rückgängig machen aus. Das angezeigte Dialogfeld kann abhängig davon variieren, ob gelöschte Elemente erkannt werden. Der erste Screenshot zeigt keine Löschungen. Die Zweite, falls Löschungen erkannt werden.

   

   

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ängigmachen, 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 der Besitzer bzw. die Besitzern des Elements wird auf die aktuelle Benutzerin bzw. den aktuellen Benutzer festgelegt.

Durch das Rückgängigmachen hinzugefügter Elemente wird das Element endgültig gelöscht.

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, Zusammenzuführungen oder Wiederherstellungen in den Arbeitsbereich zu pullen und Liveelemente zu aktualisieren. Änderungen an Ordnern werden ebenfalls aktualisiert. 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 Updates in der Quellsteuerung aus. Es wird eine Liste mit allen Elementen angezeigt, die seit der letzten Aktualisierung im Zweig geändert wurden.
4. Wählen Sie "Alle aktualisieren" aus.

5. Wählen Sie im Bestätigungsdialogfeld " Aktualisieren" aus.

Nachdem die Liste der Elemente erfolgreich aktualisiert wurde, wird die Liste der Elemente entfernt, und der Arbeitsbereich verweist auf den neuen Arbeitsbereich, mit dem sie synchronisiert wird.

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

Trennen eines Arbeitsbereichs von Git

Nur Arbeitsbereichsadministratoren können einen Arbeitsbereich von einem Git-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 im Git-Repository verfügen. Eine ausführlichere Erläuterung der Berechtigungen finden Sie unter Berechtigungen.

Zugehöriger Inhalt

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