Del via

Hvad er Microsoft Fabric Git-integration?

I denne artikel forklares det for udviklere, hvordan de integrerer Git-versionsstyring med ALM-værktøjet (Microsoft Fabric Application Lifecycle Management).

Bemærk

Nogle af elementerne til Git-integration er en prøveversion. Du kan få flere oplysninger på listen over understøttede elementer.

Git-integration i Microsoft Fabric gør det muligt for udviklere at integrere deres udviklingsprocesser, værktøjer og bedste praksis direkte i Fabric-platformen. Det giver udviklere, der udvikler i Fabric, mulighed for at:

  • Sikkerhedskopiér og version af deres arbejde
  • Vend tilbage til forrige faser efter behov
  • Samarbejd med andre, eller arbejd alene ved hjælp af Git-forgreninger
  • Anvend funktionerne i velkendte kildestyringsværktøjer til at administrere Fabric-elementer

Integrationen med versionsstyring er på arbejdsområdeniveau. Udviklere kan versionere elementer, de udvikler i et arbejdsområde, i en enkelt proces med fuld synlighed for alle deres elementer. Arbejdsområdestrukturen, herunder undermapper, bevares i Git-lageret.

Se listen over understøttede elementer.

Netværkssikkerhed til Git-integration

Sikkerhed på arbejdsområdeniveau i Microsoft Fabric giver detaljeret kontrol over dataadgang og netværksforbindelse ved at give administratorer mulighed for at konfigurere både indgående og udgående beskyttelse for individuelle arbejdsområder. Disse kontroller sikrer, at følsomme data forbliver inden for pålidelige netværksgrænser, og de integreres med CI/CD-værktøjer som Git-integration. Du kan finde flere oplysninger under Netværkssikkerhed til løbende integration/løbende installation

Oplysninger om beskyttelse af personlige oplysninger

Før du aktiverer Git-integration, skal du kontrollere, at du gennemser følgende erklæringer om beskyttelse af personlige oplysninger:

Understøttede Git-providere

Følgende Git-providere understøttes:

Understøttede elementer

Følgende elementer understøtter i øjeblikket Git-integration:

Hvis arbejdsområdet eller Git-mappen indeholder elementer, der ikke understøttes, kan det stadig være forbundet, men de elementer, der ikke understøttes, ignoreres. De gemmes eller synkroniseres ikke, men de slettes heller ikke. De vises i kildekontrolpanelet, men du kan ikke bekræfte eller opdatere dem.

Overvejelser og begrænsninger

Generelle begrænsninger for Git-integration

  • Godkendelsesmetoden i Fabric skal være mindst lige så stærk som godkendelsesmetoden for Git. Hvis Git f.eks. kræver multifaktorgodkendelse, skal Fabric også kræve multifaktorgodkendelse.
  • Power BI-datasæt, der er forbundet til Analysis Services, understøttes ikke i øjeblikket.
  • Hvis du bruger et arbejdsområdeidentitet i én artefakt og binder det til Git, kan det kun opdateres (tilbage til et stofarbejdsområde) i et arbejdsområde, der er forbundet til den samme identitet. Vær forsigtig, da dette også påvirker funktioner som f.eks. forgrening.
  • Undermoduler understøttes ikke.
  • Nationale cloudmiljøer understøttes ikke.
  • Hvis dit arbejdsområde indeholder hundredevis af elementer, kan du overveje at opdele det i mindre sæt af artefakter. Hvert sæt bør placeres i et separat arbejdsområde og linkes til en forskellig Git-gren, eller tilsluttes en enkelt gren organiseret i forskellige mapper.
  • Azure DevOps understøttes ikke, hvis Aktivér politikvalidering af IP-betinget adgang er aktiveret.
  • Hvis arbejdsområdet og Git-lageret er i to forskellige geografiske områder, skal lejeradministratoren aktivere eksport på tværs af geografiske områder.
  • Hvis din organisation har konfigureret betinget adgang, skal du sørge for, at Power BI-tjeneste har de samme betingelser, der er angivet for, at godkendelse fungerer som forventet.
  • Følgende commit-størrelsesgrænse anvendes:
    • 25 MB ved brug af Azure DevOps-connectoren med Service Principal.
    • 125 MB ved brug af standard single sign-on (SSO) Microsoft Entra ID-konto og Azure DevOps-connector med User Principal.

GitHub Enterprise-begrænsninger

Nogle GitHub Enterprise-versioner og -indstillinger understøttes ikke. Eksempler:

  • GitHub Enterprise Cloud med dataopbevaring (ghe.com)
  • GitHub Enterprise Server med et brugerdefineret domæne understøttes ikke, selvom forekomsten er offentligt tilgængelig
  • Github Enterprise Server, der hostes på et privat netværk
  • liste over tilladte IP-adresser

Azure DevOps til GitHub Enterprise migration considerations

Hvis dit team bruger Fabric Git Integration og evaluerer en migration fra Azure DevOps til GitHub Enterprise, anbefales det at køre valideringstests for at sikre, at Git Integrationsfunktionaliteten forbliver upåvirket. Fabric Git Integration er afhængig af de underliggende Git-udbyder-API'er, som adskiller sig i kapaciteter og begrænsninger mellem Azure DevOps og GitHub Enterprise, som beskrevet ovenfor.

Begrænsninger for arbejdsområde

  • Det er kun administratoren af arbejdsområdet, der kan administrere forbindelserne til Git-lageret , f.eks. oprette forbindelse, afbryde forbindelsen eller tilføje en forgrening.
    Når du har oprettet forbindelse, kan alle med tilladelse arbejde i arbejdsområdet.
  • Arbejdsområder med skabelonapps, der er installeret, kan ikke oprettes forbindelse til Git.
  • MyWorkspace kan ikke oprette forbindelse til en Git-udbyder.

Begrænsninger for forgreninger og mapper

  • Den maksimale længde på forgreningsnavnet er 244 tegn.
  • Den maksimale længde på den fulde sti til filnavne er 250 tegn. Længere navne mislykkes.
  • Den maksimale filstørrelse er 25 MB.
  • Mappestrukturen vedligeholdes op til 10 niveauer dyb.
  • Det anbefales ikke at downloade en rapport/et datasæt som .pbix fra tjenesten efter at have udrullet dem med Git-integration, da resultaterne er upålidelige. Vi anbefaler, at du bruger PowerBI Desktop til at downloade rapporter/datasæt som .pbix.
  • Hvis elementets viste navn har nogen af disse egenskaber, omdøbes mappen Git til det logiske id (GUID) og skriver:
  • Når du opretter forbindelse til et arbejdsområde, der har mapper til Git, skal du bekræfte ændringer i Git-lageret, hvis den mappestruktur, er anderledes.

Begrænsninger for mappenavn

  • Navnet på den mappe, der opretter forbindelse til Git-lageret, har følgende navngivningsbegrænsninger:

    • Mappenavnet kan ikke starte eller slutte med et mellemrum eller en fane.
    • Mappenavnet må ikke indeholde følgende tegn: "/:<>\*?|

  • Elementmappen (den mappe, der indeholder elementfilerne) må ikke indeholde følgende tegn: ":<>\*?|. Hvis du omdøber mappen til noget, der indeholder et af disse tegn, kan Git ikke oprette forbindelse til eller synkronisere med arbejdsområdet, og der opstår en fejl.

Begrænsninger for forgrening

  • Forgrening kræver tilladelser, der er angivet i tilladelsestabellen.
  • Der skal være en tilgængelig kapacitet til denne handling.
  • Alle begrænsninger for navngivning af arbejdsområder og forgreninger gælder, når du forgrener dig til et nyt arbejdsområde.
  • Det er kun Git-understøttede elementer , der er tilgængelige i det nye arbejdsområde.
  • Listen over relaterede forgreninger viser kun de forgreninger og arbejdsområder, du har tilladelse til at få vist.
  • Git-integration skal være aktiveret.
  • Når du forgrener, oprettes der en ny forgrening, og indstillingerne fra den oprindelige forgrening kopieres ikke. Juster eventuelle indstillinger eller definitioner for at sikre, at den nye opfylder organisationens politikker.
  • Når du forgrener dig til et eksisterende arbejdsområde:
    • Destinationsarbejdsområdet skal understøtte en Git-forbindelse.
    • Brugeren skal være administrator af destinationsarbejdsområdet.
    • Målarbejdsområdet skal have kapacitet.
    • Arbejdsområdet kan ikke have skabelonapps.
  • Bemærk, at når du forgrener dig til et arbejdsområde, kan elementer, der ikke er gemt i Git, gå tabt. Vi anbefaler, at du bekræfte elementer, du vil beholde, før du forgrener dig.

Begrænsninger for synkronisering og bekræftelse

  • Du kan kun synkronisere i én retning ad gangen. Du kan ikke bekræfte og opdatere på samme tid.
  • Følsomhedsmærkater understøttes ikke, og eksport af elementer med følsomhedsmærkater kan være deaktiveret. Hvis du vil bekræfte elementer, der har følsomhedsmærkater uden følsomhedsmærkaten, skal du bede administratoren om hjælp.
  • Fungerer sammen med begrænsede elementer. Elementer, der ikke understøttes i mappen, ignoreres.
  • Duplikering af navne er ikke tilladt. Selvom Power BI tillader duplikering af navne, mislykkes opdateringen, bekræftelsen eller fortrydelseshandlingen.
  • B2B understøttes ikke.
  • Konfliktløsning udføres delvist i Git.
  • Under Processen Bekræft til Git sletter Fabric-tjenesten filer i elementmappen, der ikke er en del af elementdefinitionen. Ikke-relaterede filer, der ikke findes i en elementmappe, slettes ikke.
  • Når du har bekræftet ændringerne, kan du opleve nogle uventede ændringer af det element, du ikke har foretaget. Disse ændringer er semantisk ubetydelige og kan ske af flere årsager. Eksempel:
    • Rediger elementdefinitionsfilen manuelt. Disse ændringer er gyldige, men kan være anderledes, end hvis de udføres via editorerne. Hvis du f.eks. omdøber en semantisk modelkolonne i Git og importerer denne ændring til arbejdsområdet, registreres bim-filen som ændret, næste gang du sender ændringer til den semantiske model, og den ændrede kolonne skubbes bagest i matrixencolumns. Dette skyldes, at det AS-program, der genererer bim-filerne , skubber omdøbte kolonner til slutningen af matrixen. Denne ændring påvirker ikke den måde, elementet fungerer på.
    • Bekræftelse af en fil, der bruger CRLF-linjeskift . Tjenesten bruger LF-linjeskift (linjeskift). Hvis du havde elementfiler i Git-lageret med CRLF-linjeskift , ændres disse filer til LF, når du bekræfter fra tjenesten. Hvis du f.eks. åbner en rapport på skrivebordet, skal du gemme projektfilen (.pbip) og uploade den til Git ved hjælp af CRLF-.
  • Opdatering af en semantisk model ved hjælp af API'en for udvidet opdatering medfører en Git-diff efter hver opdatering.

Relateret indhold

  • Last updated on