Een werkruimte beheren met Git (preview)

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

• Verbinding maken naar een Git-opslagplaats
• Wijzigingen doorvoeren
• Bijwerken vanuit Git
• Verbinding met Git verbreken

Het is raadzaam om het overzicht van Git-integratie te lezen voordat u begint.

Belangrijk

Deze functie is beschikbaar als preview-versie.

Vereisten

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

Vereisten voor Azure DevOps

• Een actief Azure-account dat is geregistreerd bij dezelfde gebruiker die de Fabric-werkruimte gebruikt. Maak een gratis account.
• Toegang tot een bestaande opslagplaats.

Infrastructuurvereisten

Voor toegang tot de Git-integratiefunctie hebt u een van de volgende zaken nodig:

• Power BI Premium-licentie. Een Power BI Premium-licentie ondersteunt alleen alle Power BI-items.
• Capaciteit van infrastructuur. Een Fabric-capaciteit is vereist voor het gebruik van alle ondersteunde Fabric-items.

Bovendien moet de beheerder van uw organisatie inschakelen dat gebruikers een tenant voor fabric-items kunnen maken vanuit de Beheer-portal.

een werkruimte Verbinding maken naar een Azure-opslagplaats

Alleen een werkruimtebeheerder kan een werkruimte verbinden met een Azure-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. Voer de volgende stappen uit om een werkruimte te verbinden met een Azure-opslagplaats:

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

2. Ga naar Werkruimte-instellingen

   

   Notitie

   Als u het pictogram Werkruimte-instellingen niet ziet, selecteert u het beletselteken (drie puntjes) en vervolgens werkruimte-instellingen.

3. Selecteer Git-integratie. U wordt automatisch aangemeld bij het Azure-opslagplaatsaccount dat is geregistreerd bij de Microsoft Entra-gebruiker die is aangemeld bij Fabric.

   

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

   Notitie

   U kunt een werkruimte slechts verbinden met één vertakking en één map tegelijk.

   • Organisatie
   • 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 (Selecteer een bestaande map in de vertakking of voer een naam in om een nieuwe map te maken. Als u geen map selecteert, wordt inhoud gemaakt in de hoofdmap. U kunt slechts één map tegelijk verbinden.)

5. Selecteer Verbinding maken en synchroniseer.

Als tijdens de eerste synchronisatie de werkruimte of Git-vertakking leeg is, wordt inhoud gekopieerd van de 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 initiële 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.

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 doorvoeringen.

Doorvoeren in Git

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

1. Ga naar de werkruimte.

2. Selecteer het pictogram Broncodebeheer . Dit pictogram toont het aantal niet-doorgevoerde wijzigingen.

3. Selecteer het tabblad Wijzigingen van het deelvenster Broncodebeheer . Er wordt een lijst weergegeven met alle items die u hebt gewijzigd en een pictogram dat aangeeft of het item nieuw, gewijzigd, conflict 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.

   

Nadat de wijzigingen zijn doorgevoerd, worden de items die zijn doorgevoerd uit de lijst verwijderd en verwijst de werkruimte naar de nieuwe doorvoering waarnaar deze is gesynchroniseerd.

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

Opgeslagen wijziging ongedaan maken

Als u na het opslaan van wijzigingen in de werkruimte besluit dat u deze wijzigingen niet wilt doorvoeren in Git, kunt u de wijzigingen ongedaan maken en deze items terugzetten naar de vorige status. Voer de volgende stappen uit om uw wijzigingen ongedaan te maken:

1. Ga naar de werkruimte.

2. Selecteer de knop Broncodebeheer . Met deze knop wordt ook het aantal niet-doorgevoerde wijzigingen weergegeven.

3. Selecteer het tabblad Wijzigingen van het deelvenster Broncodebeheer . Er wordt een lijst weergegeven met alle items die u hebt gewijzigd en een pictogram dat aangeeft of het gewijzigde item nieuw, gewijzigd, conflict of verwijderd is.

4. Selecteer de wijzigingen die u ongedaan wilt maken.

5. Selecteer Ongedaan maken.

   

6. Selecteer Opnieuw ongedaan maken om te bevestigen.

   

De geselecteerde items in uw werkruimte keren terug naar de wijze waarop de werkruimte voor het laatst werd gesynchroniseerd.

Belangrijk

Als u een item verwijdert en de wijzigingen ongedaan maakt, wordt het item opnieuw gemaakt en gaan sommige metagegevens mogelijk verloren. De vertrouwelijkheidslabels worden bijvoorbeeld niet bewaard en moeten opnieuw worden ingesteld en de eigenaar van het item is ingesteld op de huidige gebruiker.

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 deelvenster Broncodebeheer om de meest recente wijzigingen op te halen, samen te voegen of terug te keren naar de werkruimte en live-items bij te werken. Lees meer over het bijwerken.

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

1. Ga naar de werkruimte.
2. Selecteer het pictogram Broncodebeheer .
3. Selecteer het tabblad Updates van het deelvenster Broncodebeheer . Er wordt een lijst weergegeven met alle items die zijn gewijzigd in de vertakking sinds de laatste update.
4. Selecteer Alles bijwerken.

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

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 Azure-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. Werkruimte verbreken selecteren

   

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 Azure DevOps. Zie Machtigingen voor een gedetailleerdere bespreking van machtigingen.

Overwegingen en beperkingen

• Tijdens het doorvoeren naar Git-proces verwijdert de Fabric-service alle bestanden in de itemmap die geen deel uitmaken van de itemdefinitie. Niet-gerelateerde bestanden die zich niet in een itemmap bevinden, worden niet verwijderd.

• Nadat u wijzigingen hebt doorgevoerd, ziet u mogelijk enkele onverwachte wijzigingen in het item dat u niet hebt aangebracht. Deze wijzigingen zijn semantisch onbelangrijk en kunnen om verschillende redenen optreden. Voorbeeld:

  • Het itemdefinitiebestand handmatig wijzigen. Deze wijzigingen zijn geldig, maar zijn mogelijk anders dan wanneer ze via de editors worden uitgevoerd. Als u bijvoorbeeld de naam van een kolom met een semantisch model in Git wijzigt en deze wijziging in de werkruimte importeert, wordt het bim-bestand geregistreerd als gewijzigd en wordt de gewijzigde kolom naar de achterkant van de columns matrix gepusht. Dit komt doordat de AS-engine waarmee de bim-bestanden de hernoemde kolommen naar het einde van de matrix pusht. Deze wijziging heeft geen invloed op de manier waarop het item werkt.

  • Een bestand doorvoeren dat CRLF-regeleinden gebruikt. De service maakt gebruik van regeleinden van LF (regelinvoer). Als u itembestanden in de Git-opslagplaats met CRLF-regeleinden had, worden deze bestanden gewijzigd in LF wanneer u vanuit de service doorvoert. Als u bijvoorbeeld een rapport opent op het bureaublad, slaat u het PBIP-project op en uploadt u het naar Git met behulp van CRLF.

• Als u problemen ondervindt met deze acties, moet u de beperkingen van de Git-integratiefunctie begrijpen.

Gerelateerde inhoud

• Inzicht in het Git-integratieproces
• Git-vertakkingen beheren
• Aanbevolen procedures voor Git-integratie