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. Bare noen få elementer støttes for øyeblikket, men listen over støttede elementer vokser.
Les opp på grunnleggende Git- og versjonskontroll konsepter.
Les om den beste måten å administrere Git-grenene på.
Personverninformasjon
Før du aktiverer Git-integrering, må du kontrollere følgende personvernerklæringer:
- Personvernerklæring for Microsoft
- Oversikt over Databeskyttelse for Azure DevOps Services
- GitHub Data protection agreement
Støttede Git-leverandører
Følgende Git-leverandører støttes:
- Git i Azure Repos med samme leier som Fabric-leieren
- GitHub- (bare skyversjoner)
- GitHub Enterprise
Støttede elementer
Følgende elementer støttes for øyeblikket:
- Datasamlebånd(forhåndsversjon)
- dataflyter gen2(forhåndsversjon)
- Eventhouse- og KQL-database(forhåndsversjon)
- EventStream(forhåndsversjon)
- Lakehouse(forhåndsversjon)
- Bærbare pc
- Paginerte rapporter(forhåndsvisning)
- Refleks (forhåndsvisning)
- rapporter (unntatt rapporter som er koblet til semantiske modeller som driftes i Azure Analysis Services, SQL Server Analysis Serviceseller rapporter eksportert av Power BI Desktop som er avhengige av semantiske modeller som driftes i MyWorkspace) (forhåndsvisning)
- Semantiske modeller (unntatt push-datasett, live-tilkoblinger til Analysis Services, modell v1) (forhåndsvisning)
- Spark-jobbdefinisjoner(forhåndsversjon)
- Spark-miljø(forhåndsvisning)
- SQL-database(forhåndsvisning)
- Lagre (forhåndsversjon)
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.
- Delmoduler støttes ikke.
- 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.
- Hvis organisasjonen har konfigurert betinget tilgang, må du kontrollere at Power BI-tjenesten har de samme betingelsene som er angitt for at godkjenning skal fungere som forventet.
- Utføringsstørrelsen er begrenset til 125 MB.
Begrensninger for GitHub Enterprise
Noen GitHub Enterprise-innstillinger støttes ikke. Eksempel:
- IP-tillatelsesliste
- Privat nettverk
- Egendefinerte domener
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.
- 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
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.
- 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. 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.