Del via

Hva er Microsoft Fabric Git-integrasjon?

  • Artikkel

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. Bare noen få elementer støttes for øyeblikket, men listen over støttede elementer vokser.

  • Les opp versjonskontrollen og Git for å sikre at du er kjent med grunnleggende Git-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øttes for øyeblikket:

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.
  • Arbeidsområder med malapper installert kan ikke kobles til Git.
  • Nasjonale skyer støttes ikke.
  • Azure DevOps-kontoen må være registrert for den samme brukeren som bruker Fabric-arbeidsområdet.
  • Leieradministratoren må aktivere eksport på tvers av geografiske områder hvis arbeidsområdet og Git-repositoriet er i to forskjellige geografiske områder.
  • Utføringsstørrelsen er begrenset til 125 MB.

Begrensninger for GitHub Enterprise

Noen GitHub Enterprise-innstillinger støttes ikke. Eksempel:

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.
  • Mappestrukturen for arbeidsområdet gjenspeiles ikke i Git-repositoriet. Arbeidsområdeelementer i mapper eksporteres til rotkatalogen.

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.
  • Du kan ikke laste ned et rapport-/datasett som PBIX fra tjenesten etter at du har distribuert dem med Git-integrasjon.
  • Når du navngir en mappe i Git, legges den logiske ID-en (GUID) til som et prefiks før typen hvis elementets visningsnavn:
    • Har mer enn 256 tegn
    • Slutter med . eller et mellomrom
    • Inneholder noen av følgende tegn: " / : ? < > \ * |

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.
  • Når du forgrener deg, opprettes et nytt arbeidsområde, og innstillingene fra det opprinnelige arbeidsområdet kopieres ikke. Juster eventuelle innstillinger eller definisjoner for å sikre at det nye arbeidsområdet oppfyller organisasjonens policyer.
  • 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.

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 som endret, og den endrede kolonnen sendes til baksiden av matrisen columns neste gang du utfører endringer i den semantiske modellen. 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 PBIP-prosjektet 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