Basisconcepten in Git-integratie

In dit artikel worden de basisconcepten van Git en het proces voor het integreren van Git met uw Microsoft Fabric-werkruimte uitgelegd.

Belangrijk

Deze functie is beschikbaar als preview-versie.

Bevoegdheden

• Als u Git-integratie wilt gebruiken, moet deze worden ingeschakeld door de beheerder van uw organisatie.
• Als de werkruimte en opslagplaats zich in twee verschillende regio's bevinden, moet cross-geo-export worden ingeschakeld door de tenantbeheerder. Zie Gebruikers kunnen items exporteren naar Git-opslagplaatsen op andere geografische locaties voor meer informatie.
• De acties die u voor een werkruimte kunt uitvoeren, zijn afhankelijk van de machtigingen die u hebt in zowel de werkruimte als Azure DevOps.

Azure DevOps-machtigingen

In de volgende lijst ziet u wat verschillende werkruimterollen kunnen doen, afhankelijk van hun Azure DevOps-machtigingen:

• Beheer: kan elke bewerking uitvoeren in de werkruimte, alleen beperkt door de Azure DevOps-rol.
• Lid/inzender: zodra deze is verbonden met een werkruimte, kan een lid/inzender wijzigingen doorvoeren en bijwerken, afhankelijk van hun Azure DevOps-rol. Voor acties met betrekking tot de werkruimteverbinding (bijvoorbeeld verbinding maken, verbreken of schakelen tussen vertakkingen) zoekt u hulp van een Beheer.
• Viewer: Kan geen acties uitvoeren. De viewer kan geen git-gerelateerde informatie in de werkruimte zien.

Benodigde machtigingen voor algemene bewerkingen

In de volgende tabel worden de machtigingen beschreven die nodig zijn om verschillende algemene bewerkingen uit te voeren:

Bewerking	Werkruimterol	Git-machtigingen
Verbinding maken werkruimte naar Git-opslagplaats	Beheerder	Lezen=Toestaan
Werkruimte synchroniseren met Git-opslagplaats	Beheerder	Lezen=Toestaan
Werkruimte loskoppelen van Git-opslagplaats	Beheerder	Er zijn geen machtigingen nodig
Schakelen tussen vertakkingen in de werkruimte (of eventuele wijzigingen in de verbindingsinstelling)	Beheerder	Read=Allow (in doelopslagplaats/map/vertakking)
Git-verbindingsgegevens weergeven	Beheer, Lid, Inzender	Lezen of Geen
Werkruimte 'Git-status' bekijken	Beheer, Lid, Inzender	Lezen=Toestaan
Bijwerken vanuit Git	Alle volgende opties: Inzender in de werkruimte (schrijfmachtiging voor alle items) Eigenaar van het item (als de tenant-switch updates voor niet-eigenaren blokkeert) BOUWEN op externe afhankelijkheden (indien van toepassing)	Lezen=Toestaan
Werkruimtewijzigingen doorvoeren in Git	Alle volgende opties: Inzender in de werkruimte (schrijfmachtiging voor alle items) Eigenaar van het item (als de tenant-switch updates voor niet-eigenaren blokkeert) BOUWEN op externe afhankelijkheden (indien van toepassing)	Lezen=Toestaan Bijdragen=Toestaan vertakkingsbeleid moet directe doorvoer toestaan
Nieuwe Git-vertakking maken vanuit Fabric	Beheerder	Role=Write Vertakking maken=Toestaan

Verbinding maken en synchroniseren

Alleen een werkruimtebeheerder kan een werkruimte verbinden met Azure-opslagplaatsen, 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.

Wanneer u een werkruimte verbindt met Git, wordt Fabric gesynchroniseerd tussen de twee locaties, zodat ze dezelfde inhoud hebben. Tijdens deze eerste synchronisatie, als de werkruimte of Git-vertakking leeg is terwijl de andere inhoud heeft, wordt de inhoud gekopieerd van de lege locatie naar de lege locatie. Als zowel de werkruimte als de Git-vertakking inhoud hebben, moet u bepalen in welke richting de synchronisatie moet worden uitgevoerd.

• Als u uw werkruimte doorvoert in de Git-vertakking, wordt alle ondersteunde werkruimte-inhoud geëxporteerd naar Git en wordt de huidige Git-inhoud overschreven.
• Als u de werkruimte bijwerkt met de Git-inhoud, wordt de werkruimte-inhoud overschreven en verliest u uw werkruimte-inhoud. Omdat een Git-vertakking altijd kan worden hersteld naar een vorige fase terwijl een werkruimte dat niet kan, wordt u gevraagd om te bevestigen als u deze optie kiest.

Als u niet selecteert welke inhoud u wilt synchroniseren, kunt u pas verder werken als u dit doet:

Git-status

Nadat u verbinding hebt gemaakt, wordt in de werkruimte een Git-statuskolom weergegeven die de synchronisatiestatus aangeeft van elk item in de werkruimte ten opzichte van de items in de externe vertakking.

Elk item heeft een van de volgende statussen:

• Gesynchroniseerd (het item is hetzelfde in de werkruimte en Git-vertakking)
• Conflict (het item is gewijzigd in zowel de werkruimte als de Git-vertakking)
• Niet-ondersteund item
• Niet-doorgevoerde wijzigingen in de werkruimte
• Update vereist vanuit Git
• Item is op beide plaatsen identiek, maar moet worden bijgewerkt naar de laatste doorvoering

Synchronisatiegegevens

Zolang u verbinding hebt, wordt de volgende informatie onder aan het scherm weergegeven:

• Verbinding maken vertakking
• Tijd van laatste synchronisatie
• Koppeling naar de laatste doorvoering waarnaar de werkruimte is gesynchroniseerd

Doorvoeringen en updates

Deelvenster Broncodebeheer

Boven aan het scherm ziet u het pictogram Broncodebeheer. Het toont het aantal items dat verschilt in de werkruimte en Git-vertakking. Wanneer de werkruimte wordt gesynchroniseerd met de Git-vertakking, geeft het pictogram Broncodebeheer een 0 weer.

Wanneer er wijzigingen worden aangebracht in de werkruimte of de Git-vertakking, geeft het broncodebeheerpictogram het aantal items weer dat anders is. Selecteer het pictogram voor broncodebeheer om het deelvenster Broncodebeheer te openen.

In het deelvenster Broncodebeheer toont het tabblad Wijzigingen het aantal items dat is gewijzigd in de werkruimte en moet worden doorgevoerd in Git. Op het tabblad Updates ziet u het aantal items dat is gewijzigd in de Git-vertakking en moet worden bijgewerkt naar de werkruimte.

Op elk tabblad worden de gewijzigde items weergegeven met een pictogram dat de status aangeeft:

• Nieuw
• Bewerkt
• Verwijderd
• Conflict

Doorvoeren

• Wanneer er meer dan één item moet worden doorgevoerd, kunt u selecteren welke items u wilt doorvoeren naar de Git-vertakking.
• Als er updates zijn aangebracht in de Git-vertakking, worden doorvoeringen uitgeschakeld totdat u uw werkruimte bijwerkt.

Bijwerken

• In tegenstelling tot doorvoeren en ongedaan maken, werkt de opdracht Update altijd de hele vertakking bij en wordt gesynchroniseerd met de meest recente doorvoering. U kunt geen specifieke items selecteren die u wilt bijwerken.
• Als er wijzigingen zijn aangebracht in de werkruimte en in de Git-vertakking op hetzelfde item, worden updates uitgeschakeld totdat het conflict is opgelost.

Lees meer over het doorvoeren en bijwerken. Lees meer over het updateproces en het oplossen van conflicten.

Overwegingen en beperkingen

Algemene beperkingen

• Het Azure DevOps-account moet worden geregistreerd bij dezelfde gebruiker die de Infrastructuurwerkruimte gebruikt.
• De verificatiemethode in Power BI moet minstens zo sterk zijn als de verificatiemethode voor Azure DevOps. Als azure DevOps bijvoorbeeld meervoudige verificatie vereist, moet power BI ook meervoudige verificatie vereisen.
• Direct Query- en samengestelde modellen in Power BI-gegevenssets en Analysis Services worden momenteel niet ondersteund.
• DirectLake-semantische modellen worden momenteel niet ondersteund.
• Als u een semantisch model vernieuwt met behulp van de uitgebreide vernieuwings-API , wordt na elke vernieuwing een Git-diff veroorzaakt.

Werkruimtebeperkingen

Alleen de werkruimtebeheerder kan de verbindingen met de Azure-opslagplaats beheren, zoals verbinding maken, de verbinding verbreken of een vertakking toevoegen. Zodra er verbinding is gemaakt, kan iedereen met machtigingen in de werkruimte werken.

Beperkingen voor vertakkingen en mappen

• De maximale lengte van de vertakkingsnaam is 244 tekens.

• De maximale lengte van het volledige pad voor bestandsnamen is 250 tekens. Langere namen mislukken.

• De maximale bestandsgrootte is 25 MB.

• U kunt een rapport/gegevensset niet downloaden als PBIX vanuit de service nadat u ze met Git-integratie hebt geïmplementeerd.

• Als de weergavenaam van het item:

  • Heeft meer dan 256 tekens
  • Eindigt op .' of een spatie
  • Bevat een van de volgende tekens: ", , :/, , <, , *\\?>|

  De logische id (Guid) wordt toegevoegd als een voorvoegsel voor het type, bij het benoemen van de map in Git.

Beperkingen voor synchroniseren en doorvoeren

• De groottelimiet voor een doorvoer is 125 MB.
• U kunt slechts in één richting synchroniseren. U kunt niet tegelijkertijd doorvoeren en bijwerken.
• Vertrouwelijkheidslabels worden niet ondersteund en het exporteren van items met vertrouwelijkheidslabels is mogelijk uitgeschakeld. Als u items met vertrouwelijkheidslabels zonder het vertrouwelijkheidslabel wilt doorvoeren, vraagt u de beheerder om hulp.
• Werkt met beperkte items. Als niet-ondersteunde items zich in de map bevinden, worden ze genegeerd.
• Het dupliceren van namen is niet toegestaan, zelfs niet als Power BI dit toestaat, mislukt de update, doorvoer of ongedaan maken van de actie.
• B2B wordt niet ondersteund.
• Conflictoplossing wordt gedeeltelijk uitgevoerd in Git.

Gerelateerde inhoud

• Vertakkingen beheren
• Fouten en conflicten oplossen