Aan de slag met Git-integratie

In dit artikel worden de volgende basistaken beschreven in het Git-integratiehulpprogramma van Microsoft Fabric:

We raden u aan het overzicht van Git-integratie te lezen voordat u begint.

Vereisten

Als u Git wilt integreren met uw Microsoft Fabric-werkruimte, moet u de volgende vereisten instellen voor zowel Fabric als Git.

Voorgestelde vereisten voor Fabric

Als u de Git-integratiefunctie wilt access, hebt u een Fabric-capaciteit nodig. Een Fabric-capaciteit is vereist om alle ondersteunde Fabric-items te gebruiken. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis proefversie. Klanten die al een Power BI Premium-capaciteit hebben, kunnen die capaciteit gebruiken, maar houd er rekening mee dat bepaalde Power BI-SKU's alleen Power BI-items ondersteunen.

Bovendien moeten de volgende tenantswitches zijn ingeschakeld vanuit de beheerportal:

Deze switches kunnen worden ingeschakeld door de tenantbeheerder, capaciteitsbeheerder of werkruimtebeheerder, afhankelijk van de instellingen van uw organisatie.

Git-vereisten

Git-integratie wordt momenteel ondersteund voor Azure DevOps en GitHub. Als u Git-integratie met uw Fabric-werkruimte wilt gebruiken, hebt u het volgende nodig in Azure DevOps of GitHub:

  • Een Active Azure DevOps-account geregistreerd bij dezelfde Fabric-gebruiker (ondersteund zelfs als Azure DevOps-organisatie zich in een andere tenant bevindt dan de Fabric-tenant). Maak een gratis account.
  • Access naar een bestaande opslagplaats.

Een werkruimte verbinden met een Git-opslagplaats

Verbinding maken met een Git-opslagplaats

Alleen een werkruimtebeheerder kan een werkruimte verbinden met een opslagplaats, maar zodra deze is verbonden, kan iedereen met machtigingen in de werkruimte werken. Als u geen beheerder bent, vraagt u uw beheerder om hulp bij het maken van verbinding. Als u een werkruimte wilt verbinden met een Azure of GitHub opslagplaats, voert u de volgende stappen uit:

  1. Meld u aan bij Fabric en navigeer naar de werkruimte waarmee u verbinding wilt maken.

  2. Ga naar Werkruimte-instellingen

    Schermopname van de werkruimte met het pictogram werkruimte-instellingen bovenaan weergegeven.

  3. Selecteer Git-integratie.

  4. Selecteer uw Git-provider. Momenteel worden Azure DevOps en GitHub ondersteund.

Als u Azure DevOps selecteert, selecteert u Connect om u automatisch aan te melden bij het Azure-opslagplaatsen-account dat is geregistreerd bij de Microsoft Entra-gebruiker die is aangemeld bij Fabric.

Als u zich al hebt aangemeld bij Azure vanuit Fabric met een ander account, selecteert u uw account in de lijst en selecteert u Connect.

Als het de eerste keer is dat u zich aanmeldt vanuit Fabric of als u een nieuw account wilt toevoegen, selecteert u Account toevoegen.

Als het de eerste keer is dat u verbinding maakt, moet u uw gebruiker autoriseren. Geef de volgende informatie op:

  • Weergavenaam : moet uniek zijn voor elke gebruiker
  • Azure DevOps-URL - URL van de Azure DevOps-opslagplaats. DE URL moet de indeling hebben https://dev.azure.com/{organization}/{project}/_git/{repository} of https://{organization}.visualstudio.com/{project}/_git/{repo}.
  • Verificatie : u kunt zich verifiëren met OAuth2 of een service-principal. Zie Azure DevOps - Git-integratie met service-principal voor meer informatie

Schermopname van de GitHub-integratie-gebruikersinterface om een account toe te voegen.

Nadat u zich hebt aangemeld, selecteert u Connect zodat Fabric uw account kan access

Verbinding maken met een werkruimte

Als de werkruimte al is verbonden met Azure DevOps/GitHub, volgt u de instructies voor Verbinding maken met een gedeelde werkruimte.

  1. Geef in het vervolgkeuzemenu de volgende details op over de vertakking waarmee u verbinding wilt maken:

    • Organization
    • Project
    • Git-opslagplaats.
    • Vertakking (Selecteer een bestaande vertakking met behulp van de vervolgkeuzelijst of selecteer + Nieuwe vertakking om een nieuwe vertakking te maken. U kunt slechts verbinding maken met één vertakking tegelijk.)
    • Map (typ de naam van een bestaande map of voer een naam in om een nieuwe map te maken. Als u de mapnaam leeg laat, wordt inhoud gemaakt in de hoofdmap. U kunt slechts één map tegelijk verbinden.)

Schermopname naar Azure-verbinding.

Selecteer Verbinding maken en synchroniseren.

Als tijdens de eerste synchronisatie de werkruimte of Git-vertakking leeg is, wordt inhoud gekopieerd van de niet-lege locatie naar de lege locatie. Als zowel de werkruimte als de Git-vertakking inhoud hebben, wordt u gevraagd in welke richting de synchronisatie moet worden uitgevoerd. Zie Verbinding maken en synchroniseren voor meer informatie over deze eerste synchronisatie.

Nadat u verbinding hebt gemaakt, geeft de werkruimte informatie weer over broncodebeheer waarmee de gebruiker de verbonden vertakking, de status van elk item in de vertakking en de tijd van de laatste synchronisatie kan bekijken.

Schermopname van het broncodebeheerpictogram en andere Git-informatie.

Als u uw werkruimte gesynchroniseerd wilt houden met de Git-vertakking, voert u eventuele wijzigingen in de werkruimte door in de Git-vertakking en werkt u uw werkruimte bij wanneer iemand nieuwe doorvoeringen naar de Git-vertakking maakt.

Wijzigingen doorvoeren in Git

Nadat u verbinding hebt gemaakt met een Git-map, bewerkt u uw werkruimte zoals gebruikelijk. Alle wijzigingen die u opslaat, worden alleen opgeslagen in de werkruimte. Wanneer u klaar bent, kunt u uw wijzigingen doorvoeren in de Git-vertakking of de wijzigingen ongedaan maken en terugkeren naar de vorige status.

Lees meer over commits.

Voer de volgende stappen uit om uw wijzigingen door te voeren in de Git-vertakking:

  1. Ga naar de werkruimte.

  2. Kies het pictogram Bronbeheer. Dit pictogram toont het aantal niet-doorgevoerde wijzigingen. Schermopname van het broncodebeheerpictogram met het getal 2 dat aangeeft dat er twee wijzigingen moeten worden doorgevoerd.

  3. Selecteer de wijzigingen in het bronbeheerpaneel. Er wordt een lijst weergegeven met alle items die u hebt gewijzigd en een pictogram dat aangeeft of het item nieuw , gewijzigd , conflict , dezelfde wijziging of verwijderd is.

  4. Selecteer de items die u wilt doorvoeren. Als u alle items wilt selecteren, schakelt u het bovenste selectievakje in.

  5. Voeg een opmerking toe in het vak. Als u geen opmerking toevoegt, wordt automatisch een standaardbericht toegevoegd.

  6. Selecteer Doorvoeren.

    Schermopname van het bronbeheervenster met twee wijzigingen geselecteerd om door te voeren.

Nadat de wijzigingen zijn doorgevoerd, worden de doorgevoerde items uit de lijst verwijderd en verwijst de werkruimte naar de nieuwe commit waarmee deze is gesynchroniseerd.

Schermopname van het venster broncodebeheer waarin wordt aangegeven dat er geen wijzigingen zijn doorgevoerd.

Nadat de doorvoering is voltooid, wordt de status van de geselecteerde items gewijzigd van Niet-doorgevoerd in Gesynchroniseerd.

Werkruimte bijwerken vanuit Git

Wanneer iemand een nieuwe wijziging doorvoert in de verbonden Git-vertakking, wordt er een melding weergegeven in de relevante werkruimte. Gebruik het bronbeheerpaneel om de meest recente wijzigingen op te halen, samen te voegen of terug te zetten in de werkruimte en live-items bij te werken. Wijzigingen in mappen worden ook bijgewerkt. Lees meer over het bijwerken.

Voer de volgende stappen uit om een werkruimte bij te werken:

  1. Ga naar de werkruimte.
  2. Kies het pictogram Bronbeheer.
  3. Selecteer Updates van het bronconfiguratiepaneel. Er verschijnt een lijst met alle items die sinds de laatste update in de tak zijn gewijzigd.
  4. Selecteer Alles bijwerken.

Schermopname van bron control panel met het tabblad Bijwerken geopend en de knop Alle bijwerken geselecteerd.

  1. Selecteer Bijwerken in het bevestigingsvenster.

Schermopname van bevestigingsdialoogvenster.

Nadat deze is bijgewerkt, wordt de lijst met items verwijderd en verwijst de werkruimte naar de nieuwe werkruimte waarmee deze is gesynchroniseerd.

Schermopname van het venster broncodebeheer waarin staat dat u de werkruimte hebt bijgewerkt.

Nadat de update is voltooid, wordt de status van de items gewijzigd in Gesynchroniseerd.

Een werkruimte loskoppelen van Git

Alleen een werkruimtebeheerder kan een werkruimte loskoppelen van een Git-opslagplaats. Als u geen beheerder bent, vraagt u uw beheerder om hulp bij het verbreken van de verbinding. Als u een beheerder bent en de verbinding met uw opslagplaats wilt verbreken, voert u de volgende stappen uit:

  1. Ga naar Werkruimte-instellingen
  2. Git-integratie selecteren
  3. Selecteer werkruimte loskoppelen
  4. Selecteer Opnieuw verbinding verbreken om te bevestigen.

Machtigingen

De acties die u voor een werkruimte kunt uitvoeren, zijn afhankelijk van de machtigingen die u hebt in zowel de werkruimte als de Git-opslagplaats. Zie Machtigingen voor een gedetailleerdere bespreking van machtigingen.