Del via

Hvad er Microsoft Fabric Git-integration?

  • Artikel

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. Det er kun nogle få elementer, der understøttes i øjeblikket, men listen over understøttede elementer vokser.

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øttes i øjeblikket:

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.
  • Arbejdsområder med skabelonapps, der er installeret, kan ikke oprettes forbindelse til Git.
  • Undermoduler understøttes ikke.
  • Nationale cloudmiljøer understøttes ikke.
  • Azure DevOps-kontoen skal være registreret for den samme bruger, der bruger Fabric-arbejdsområdet.
  • Lejeradministratoren skal aktivere eksporter på tværs af geografiske områder, hvis arbejdsområdet og Git-lageret er i to forskellige geografiske områder.
  • Hvis din organisation har konfigureret betinget adgang, skal du sørge for, at Power BI-tjenesten har de samme betingelser, som er angivet for godkendelse, så den fungerer som forventet.
  • Bekræftelsesstørrelsen er begrænset til 125 MB.

GitHub Enterprise-begrænsninger

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

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ådets mappestruktur afspejles ikke i Git-lageret. Arbejdsområdeelementer i mapper eksporteres til rodmappen.

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.
  • Du kan ikke downloade en rapport/et datasæt som .pbix fra tjenesten, når du har udrullet dem med Git-integration.
  • Hvis elementets viste navn har nogen af disse egenskaber, omdøbes mappen Git til det logiske id (GUID) og skriver:

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.
  • Når du forgrener dig, oprettes der et nyt arbejdsområde, og indstillingerne fra det oprindelige arbejdsområde kopieres ikke. Juster eventuelle indstillinger eller definitioner for at sikre, at det nye arbejdsområde opfylder organisationens politikker.
  • 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.

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