Delen via

Inleiding tot Git-integratie (preview)

  • Artikel

In dit artikel wordt uitgelegd hoe ontwikkelaars Git-versiebeheer integreren met het hulpprogramma Alm (Fabric Application Lifecycle Management).

Belangrijk

Deze functie is beschikbaar als preview-versie.

Met Git-integratie in Microsoft Fabric kunnen ontwikkelaars hun ontwikkelprocessen, hulpprogramma's en best practices rechtstreeks integreren in het Fabric-platform. Hiermee kunnen ontwikkelaars die in Fabric ontwikkelen het volgende doen:

  • Back-up en versie van hun werk
  • Naar behoefte terugkeren naar vorige fasen
  • Samenwerken met anderen of alleen werken met Git-vertakkingen
  • De mogelijkheden van vertrouwde hulpprogramma's voor broncodebeheer toepassen om Fabric-items te beheren

De integratie met broncodebeheer bevindt zich op werkruimteniveau. Ontwikkelaars kunnen in één proces versie-items maken die ze ontwikkelen binnen een werkruimte, met volledige zichtbaarheid van al hun items. Momenteel worden in de preview slechts enkele items ondersteund, maar de lijst met ondersteunde items groeit.

Privacyinformatie

Voordat u Git-integratie inschakelt, moet u de volgende privacyverklaringen bekijken:

Ondersteunde Git-providers

De volgende Git-providers worden ondersteund:

Ondersteunde items

De volgende items worden momenteel ondersteund:

Als de werkruimte of Git-map niet-ondersteunde items bevat, kan deze nog steeds worden verbonden, maar worden de niet-ondersteunde items genegeerd. Ze worden niet opgeslagen of gesynchroniseerd, maar ze worden ook niet verwijderd. Ze worden weergegeven in het configuratiescherm van de bron, maar u kunt ze niet doorvoeren of bijwerken.

Overwegingen en beperkingen

Algemene beperkingen voor Git-integratie

  • De verificatiemethode in Fabric moet ten minste zo sterk zijn als de verificatiemethode voor Git. Als Git bijvoorbeeld meervoudige verificatie vereist, moet Fabric ook meervoudige verificatie vereisen.
  • Power BI-gegevenssets die zijn verbonden met Analysis Services worden momenteel niet ondersteund.
  • Onafhankelijke clouds worden niet ondersteund.
  • Het Azure DevOps-account moet worden geregistreerd bij dezelfde gebruiker die de Infrastructuurwerkruimte gebruikt.
  • De tenantbeheerder moet cross-geo-exports inschakelen als de werkruimte en git-opslagplaats zich in twee verschillende geografische regio's bevinden.
  • De doorvoergrootte is beperkt tot 125 MB.

Beperkingen voor GitHub Enterprise

Sommige GitHub Enterprise-instellingen worden niet ondersteund. Voorbeeld:

  • IP-acceptatielijst
  • Privénetwerken

Werkruimtebeperkingen

  • Alleen de werkruimtebeheerder kan de verbindingen met de Git-opslagplaats beheren, zoals verbinding maken, verbinding verbreken of een vertakking toevoegen.
    Zodra er verbinding is gemaakt, kan iedereen met machtigingen in de werkruimte werken.
  • De structuur van de werkruimtemap wordt niet weergegeven in de Git-opslagplaats. Werkruimte-items in mappen worden geëxporteerd naar de hoofdmap.

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.
  • Bij het benoemen van een map in Git wordt de logische id (Guid) toegevoegd als een voorvoegsel voor het type als de weergavenaam van het item:
    • Heeft meer dan 256 tekens
    • Eindigt met . of een spatie
    • Bevat een van de volgende tekens: " / : ? > < \ * |

Beperkingen voor uittakken

  • Vertakking vereist machtigingen die worden vermeld in de machtigingstabel.
  • Er moet een beschikbare capaciteit zijn voor deze actie.
  • Alle beperkingen voor naamgeving van werkruimten en vertakkingen zijn van toepassing bij het vertakken naar een nieuwe werkruimte.
  • Wanneer u vertakt, wordt er een nieuwe werkruimte gemaakt en worden de instellingen van de oorspronkelijke werkruimte niet gekopieerd. Pas instellingen of definities aan om ervoor te zorgen dat de nieuwe werkruimte voldoet aan het beleid van uw organisatie.
  • Alleen door Git ondersteunde items zijn beschikbaar in de nieuwe werkruimte.
  • In de lijst met gerelateerde vertakkingen worden alleen vertakkingen en werkruimten weergegeven die u kunt weergeven.
  • Git-integratie moet zijn ingeschakeld.

Beperkingen voor synchroniseren en doorvoeren

  • 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. Niet-ondersteunde items in de map worden genegeerd.
  • Het dupliceren van namen is niet toegestaan. Zelfs als in Power BI duplicatie van namen is toegestaan, mislukt de update, doorvoer of ongedaan maken.
  • B2B wordt niet ondersteund.
  • Conflictoplossing wordt gedeeltelijk uitgevoerd in Git.
  • Tijdens het doorvoeren naar Git-proces verwijdert de Fabric-service bestanden in de itemmap die geen deel uitmaken van de itemdefinitie. Niet-gerelateerde bestanden die niet in een itemmap staan, 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. Bijvoorbeeld:
    • 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 een semantisch model vernieuwt met behulp van de uitgebreide vernieuwings-API , wordt na elke vernieuwing een Git-diff veroorzaakt.

Gerelateerde inhoud