Del via

Hva er Microsoft Fabric Git-integrasjon?

Denne artikkelen forklarer utviklere hvordan de integrerer Git-versjonskontroll med verktøyet microsoft Fabric Application lifecycle management (ALM).

Merk

Noen av elementene for Git-integrering er i forhåndsvisning. Hvis du vil ha mer informasjon, kan du se listen over støttede elementer.

Git-integrering i Microsoft Fabric gjør det mulig for utviklere å integrere utviklingsprosesser, verktøy og anbefalte fremgangsmåter direkte i Fabric-plattformen. Det gjør det mulig for utviklere som utvikler seg i Fabric å:

  • Sikkerhetskopier og versjon av arbeidet deres
  • Gå tilbake til tidligere faser etter behov
  • Samarbeide med andre eller arbeide alene ved hjelp av Git-grener
  • Bruk egenskapene til kjente kildekontrollverktøy for å administrere Fabric-elementer

Integreringen med kildekontrollen er på arbeidsområdenivå. Utviklere kan versjonselementer de utvikler i et arbeidsområde i én enkelt prosess, med full synlighet for alle elementene sine. Arbeidsområdestrukturen, inkludert undermapper, bevares i Git-repositoriet.

Se listen over støttede elementer.

  • Les opp på grunnleggende Git- og versjonskontroll konsepter.

  • Les mer om Git-integreringsprosessen.

  • Les om den beste måten å administrere Git-grenene på.

Personverninformasjon

Før du aktiverer Git-integrering, må du kontrollere følgende personvernerklæringer:

Støttede Git-leverandører

Følgende Git-leverandører støttes:

Støttede elementer

Følgende elementer støtter for øyeblikket Git-integrasjon:

Hvis arbeidsområdet eller Git-katalogen har elementer som ikke støttes, kan det fortsatt være tilkoblet, men elementene som ikke støttes, ignoreres. De lagres ikke eller synkroniseres, men de slettes heller ikke. De vises i kildekontrollpanelet, men du kan ikke utføre eller oppdatere dem.

Hensyn og begrensninger

Generelle begrensninger for Git-integrering

  • Godkjenningsmetoden i Fabric må være minst like sterk som godkjenningsmetoden for Git. Hvis Git for eksempel krever godkjenning med flere faktorer, må Fabric også kreve godkjenning med flere faktorer.
  • Power BI-datasett som er koblet til Analysis Services, støttes foreløpig ikke.
  • Hvis du bruker en arbeidsområdeidentitet i én artefakt og forplikter den til Git, kan den oppdateres (tilbake til et stoffarbeidsområde) bare i et arbeidsområde som er koblet til samme identitet. Vær forsiktig, da dette også påvirker funksjoner som gren ut.
  • Delmoduler støttes ikke.
  • Nasjonale skyer støttes ikke.

Begrensninger for GitHub Enterprise

Enkelte GitHub Enterprise-versjoner og -innstillinger støttes ikke. Eksempel:

  • GitHub Enterprise Cloud med datalagring (ghe.com)
  • GitHub Enterprise Server med et egendefinert domene støttes ikke, selv om forekomsten er offentlig tilgjengelig
  • Github Enterprise Server driftet på et privat nettverk
  • IP-tillatelsesliste

Arbeidsområdebegrensninger

  • Bare administratoren for arbeidsområdet kan administrere tilkoblingene til Git-repositoriet , for eksempel koble til, koble fra eller legge til en gren.
    Når de er tilkoblet, kan alle med tillatelse arbeide i arbeidsområdet.
  • Arbeidsområder med malapper installert kan ikke kobles til Git.
  • MyWorkspace- kan ikke koble til en Git-leverandør.

Begrensninger for gren og mappe

  • Maksimal lengde på grennavnet er 244 tegn.
  • Maksimal lengde på fullstendig bane for filnavn er 250 tegn. Lengre navn mislykkes.
  • Maksimal filstørrelse er 25 MB.
  • Mappestrukturen opprettholdes opptil ti nivåer dypt.
  • Det anbefales ikke å laste ned et rapport-/datasett som PBIX fra tjenesten etter at du har distribuert dem med Git-integrering, siden resultatene er upålitelige. Vi anbefaler at du bruker PowerBI Desktop til å laste ned rapporter/datasett som PBIX.
  • Hvis elementets visningsnavn har noen av disse egenskapene, får Git-mappen nytt navn til den logiske ID-en (GUID) og skriver:
    • Har mer enn 256 tegn
    • Slutter med en . eller et mellomrom
    • Inneholder forbudte tegn som beskrevet i katalognavnbegrensninger
  • Når du kobler et arbeidsområde som har mapper til Git, må du utføre endringer i Git-repositoriet hvis den mappestrukturen er annerledes.

Begrensninger for katalognavn

  • Navnet på katalogen som kobler til Git-repositoriet, har følgende navnebegrensninger:

    • Katalognavnet kan ikke begynne eller slutte med et mellomrom eller en fane.
    • Katalognavnet kan ikke inneholde noen av følgende tegn: "/:<>\*?|

  • Elementmappen (mappen som inneholder elementfilene) kan ikke inneholde noen av følgende tegn: ":<>\*?|. Hvis du endrer navnet på mappen til noe som inneholder ett av disse tegnene, kan ikke Git koble til eller synkronisere med arbeidsområdet, og det oppstår en feil.

Begrensninger for forgrening

  • Forgrening krever tillatelser oppført i tillatelsestabellen.
  • Det må være en tilgjengelig kapasitet for denne handlingen.
  • Alle begrensninger for navngivning av arbeidsområder og forgreninger gjelder når du forgrener deg til et nytt arbeidsområde.
  • Bare Git-støttede elementer er tilgjengelige i det nye arbeidsområdet.
  • Listen over relaterte grener viser bare grener og arbeidsområder du har tillatelse til å vise.
  • Git-integrasjon må være aktivert.
  • Når du forgrener deg, opprettes en ny gren, og innstillingene fra den opprinnelige grenen kopieres ikke. Juster eventuelle innstillinger eller definisjoner for å sikre at den nye oppfyller organisasjonens policyer.
  • Når du forgrener til et eksisterende arbeidsområde:
    • Målarbeidsområdet må støtte en Git-tilkobling.
    • Brukeren må være administrator for målarbeidsområdet.
    • Målarbeidsområdet må ha kapasitet.
    • Arbeidsområdet kan ikke ha malapper.
  • Vær oppmerksom på at når du forgrener deg til et arbeidsområde, kan alle elementer som ikke er lagret i Git, gå seg vill. Vi anbefaler at du utføre elementer du vil beholde før du forgrener deg.

Synkroniser og utfør begrensninger

  • Du kan bare synkronisere i én retning om gangen. Du kan ikke utføre og oppdatere samtidig.
  • Følsomhetsetiketter støttes ikke, og eksport av elementer med følsomhetsetiketter kan være deaktivert. Hvis du vil utføre elementer som har følsomhetsetiketter uten følsomhetsetiketten, kan du be systemansvarlig om hjelp.
  • Fungerer med begrensede elementer. Elementer som ikke støttes i mappen, ignoreres.
  • Duplisering av navn er ikke tillatt. Selv om Power BI tillater navneduplisering, mislykkes oppdateringen, utføringen eller angrehandlingen.
  • B2B støttes ikke.
  • Konfliktløsning utføres delvis i Git.
  • Under Prosessen Utfør til Git sletter Fabric-tjenesten filer i elementmappen som ikke er en del av elementdefinisjonen. Ikke-relaterte filer som ikke er i en elementmappe, slettes ikke.
  • Når du har gjort endringer, vil du kanskje legge merke til noen uventede endringer i elementet du ikke har gjort. Disse endringene er semantisk ubetydelige og kan skje av flere grunner. Eksempel:
    • Endre elementdefinisjonsfilen manuelt. Disse endringene er gyldige, men kan være annerledes enn hvis de gjøres gjennom redigeringsprogram. Hvis du for eksempel gir nytt navn til en semantisk modellkolonne i Git og importerer denne endringen til arbeidsområdet, registreres bim-filen. Dette er fordi AS-motoren som genererer bim-filene , sender kolonner med nytt navn til slutten av matrisen. Denne endringen påvirker ikke måten elementet fungerer på.
    • Utfører en fil som bruker CRLF-linjeskift . Tjenesten bruker linjeskift (linjefeed). Hvis du hadde elementfiler i Git-repositoriet med CRLF-linjeskift , endres disse filene til LF når du utfører fra tjenesten. Hvis du for eksempel åpner en rapport på skrivebordet, lagrer du prosjektfilen (.pbip) og laster den opp til Git ved hjelp av CRLF-.
  • Oppdatering av en semantisk modell ved hjelp av API-en for forbedret oppdatering forårsaker en Git-diff etter hver oppdatering.

Relatert innhold