Kom i gang med Git-integrasjon

Denne artikkelen veileder deg gjennom følgende grunnleggende oppgaver i Microsoft Fabrics Git-integreringsverktøy:

• Koble til et Git-repositorium
• Utfør endringer
• Oppdater fra Git
• Koble fra Git

Vi anbefaler at du leser oversikt over Git-integrering før du begynner.

Forutsetning

Hvis du vil integrere Git med Microsoft Fabric-arbeidsområdet, må du konfigurere følgende forutsetninger for både Fabric og Git.

Forutsetninger for stoff

Hvis du vil ha tilgang til Git-integreringsfunksjonen, trenger du en Fabric-kapasitet. En stoffkapasitet kreves for å bruke alle støttede stoffelementer. Hvis du ikke har en ennå, kan du registrere deg for en gratis prøveversjon. Kunder som allerede har en Power BI Premium-kapasitet, kan bruke denne kapasiteten, men husk at bestemte Power BI-SKU-er bare støtter Power BI-elementer.

I tillegg må følgende leierbrytere være aktivert fra administrasjonsportalen:

• Brukere kan opprette Fabric-elementer
• Brukere kan synkronisere arbeidsområdeelementer med Git-repositoriene sine
• Bare For GitHub-brukere: Brukere kan synkronisere arbeidsområdeelementer med GitHub-repositorier

Disse bryterne kan aktiveres av leieradministrator, kapasitetsadministrator eller arbeidsområdeadministrator, avhengig av organisasjonens innstillinger.

Git-forutsetninger

Git-integrasjon støttes for øyeblikket for Azure DevOps og GitHub. Hvis du vil bruke Git-integrering med Fabric-arbeidsområdet, trenger du følgende i Azure DevOps eller GitHub:

Begrensninger for Azure DevOps

• En aktiv Azure-konto registrert til samme bruker som bruker Fabric-arbeidsområdet. Opprett en gratis konto.
• Tilgang til et eksisterende repositorium.

GitHub-begrensninger

• En aktiv GitHub-konto. Opprett en GitHub-konto.

• Ett av følgende personlige tilgangstokener:

  • Et finkornet token (anbefales) med lese- og skrivetillatelse for innhold under repositoriumtillatelsene:

    

    Hvis du vil bruke dette tokenet med GitHub Enterprise, følger du disse instruksjonene.

  • Et klassisk GitHub-token med repo-omfang aktivert:

    

Koble et arbeidsområde til et Git-repositorium

Koble til et Git-repositorium

Bare en administrator for arbeidsområdet kan koble et arbeidsområde til et repositorium, men når de er tilkoblet, kan alle med tillatelse arbeide i arbeidsområdet. Hvis du ikke er administrator, kan du be administratoren om hjelp med å koble til. Følg disse trinnene for å koble et arbeidsområde til en Azure- eller GitHub-repositorium:

1. Logg på Fabric, og gå til arbeidsområdet du vil koble til.

2. Gå til innstillinger for arbeidsområde

   

3. Velg Git-integrasjon.

4. Velg Git-leverandøren. Azure DevOps og GitHub støttes for øyeblikket.

Azure DevOps Connect

Hvis du velger Azure DevOps, velger du Koble til for å logge på Azure Repos-kontoen som er registrert til Microsoft Entra-brukeren som er logget på Fabric automatisk.

GitHub Connect

Hvis du velger GitHub, må du logge på GitHub-kontoen din.
Velg Legg til konto hvis det er første gang du logger på fra Fabric, eller velg en av kontoene som er oppført. Når du har logget på, velger du Koble til for å gi Fabric tilgang til GitHub-kontoen.

Hvis det er første gang du kobler til , må du godkjenne GitHub-brukeren. Angi følgende informasjon:

• Visningsnavn – må være unikt for hver GitHub-bruker
• Personlig tilgang token - din klassiske eller finkornede personlige tilgangstoken
• Nettadresse for repositorium (valgfritt) – Hvis du ikke skriver inn en nettadresse, kan du koble til et hvilket som helst repositorium du har tilgang til. Hvis du skriver inn en URL-adresse, kan du bare koble til dette repositoriet.

Koble til et arbeidsområde

Hvis arbeidsområdet allerede er koblet til GitHub, følger du instruksjonene for å koble til et delt arbeidsområde.

Azure DevOps-grentilkobling

1. Angi følgende detaljer om grenen du vil koble til, fra rullegardinmenyen:

   • Organisasjon
   • Prosjekt
   • Git-repositorium.
   • Gren (velg en eksisterende gren ved hjelp av rullegardinmenyen, eller velg + Ny gren for å opprette en ny gren. Du kan bare koble til én gren om gangen.)
   • Mappe (skriv inn navnet på en eksisterende mappe, eller skriv inn et navn for å opprette en ny mappe. Hvis du lar mappenavnet stå tomt, opprettes innholdet i rotmappen. Du kan bare koble til én mappe om gangen.)

GitHub-grentilkobling

1. Angi følgende detaljer om grenen du vil koble til, fra rullegardinmenyen:

   • URL-adresse for repositorium. Hvis du koblet til GitHub ved hjelp av et omfangstoken, fylles nettadressen automatisk ut, og du kan bare koble til dette repositoriet.
   • Gren (velg en eksisterende gren ved hjelp av rullegardinmenyen, eller velg + Ny gren for å opprette en ny gren. Du kan bare koble til én gren om gangen.)
   • Mappe (skriv inn navnet på en eksisterende mappe, eller skriv inn et navn for å opprette en ny mappe. Hvis du lar mappenavnet stå tomt, opprettes innholdet i rotmappen. Du kan bare koble til én mappe om gangen.)

Velg Koble til og synkroniser.

Under den første synkroniseringen, hvis arbeidsområdet eller Git-grenen er tom, kopieres innholdet fra den ikke-tomme plasseringen til den tomme. Hvis både arbeidsområdet og Git-grenen har innhold, blir du spurt om hvilken retning synkroniseringen skal gå. Hvis du vil ha mer informasjon om denne første synkroniseringen, kan du se Koble til og synkronisere.

Når du har koblet til, viser arbeidsområdet informasjon om kildekontroll som gjør det mulig for brukeren å vise den tilkoblede grenen, statusen for hvert element i grenen og tidspunktet for den siste synkroniseringen.

Hvis du vil holde arbeidsområdet synkronisert med Git-grenen, må du utføre endringer du gjør i arbeidsområdet, til Git-grenen og oppdatere arbeidsområdet når noen oppretter nye forpliktelser til Git-grenen.

Utfør endringer i git

Når du har koblet til en Git-mappe, kan du redigere arbeidsområdet som vanlig. Alle endringer du lagrer, lagres bare i arbeidsområdet. Når du er klar, kan du utføre endringene i Git-grenen, eller du kan angre endringene og gå tilbake til forrige status.

Les mer om utføringer.

Forplikte til Git

Følg disse trinnene for å utføre endringene i Git-grenen:

1. Gå til arbeidsområdet.

2. Velg kildekontrollikonet. Dette ikonet viser antall uforpliktende endringer.

3. Velg endringene fra kildekontrollpanelet. En liste vises med alle elementene du har endret, og et ikon som angir om elementet er nytt, endret , konflikteller slettet .

4. Merk elementene du vil utføre. Hvis du vil merke alle elementene, merker du av i den øverste boksen.

5. Legg til en kommentar i boksen. Hvis du ikke legger til en kommentar, legges det automatisk til en standardmelding.

6. Velg Utfør.

   

Når endringene er utført, fjernes elementene som ble utført, fra listen, og arbeidsområdet peker på den nye utførelsen den synkroniserte til.

Når utføringen er fullført, endres statusen for de valgte elementene fra Uforpliktende til Synkronisert.

Angre lagret endring

Når du har lagret endringer i arbeidsområdet, kan du angre endringene og tilbakestille disse elementene til den forrige statusen hvis du bestemmer deg for at du ikke vil utføre disse endringene i git. Følg disse trinnene for å angre endringene:

1. Gå til arbeidsområdet.

2. Velg Kildekontroll-knappen. Denne knappen viser også antall uforpliktende endringer.

3. Velg Endringer fra kildekontrollpanelet . En liste vises med alle elementene du endret, og et ikon som angir om det endrede elementet er nytt, endret , konflikteller slettet .

4. Merk endringene du vil angre.

5. Velg Angre.

   

6. Velg Angre på nytt for å bekrefte.

   

De valgte elementene i arbeidsområdet går tilbake til hvordan de var da arbeidsområdet sist ble synkronisert.

Viktig

Hvis du sletter et element og deretter angrer endringene, opprettes elementet på nytt, og noen av metadataene kan gå tapt. Følsomhetsetikettene beholdes for eksempel ikke og bør tilbakestilles, og eieren av elementet er satt til gjeldende bruker.

Oppdater arbeidsområde fra Git

Når noen utfører en ny endring i den tilkoblede Git-grenen, vises et varsel i det aktuelle arbeidsområdet. Bruk Kilde-kontrollpanelet til å hente de nyeste endringene, flettingene eller gå tilbake til arbeidsområdet og oppdatere levende elementer. Endringer i mapper oppdateres også. Les mer om oppdatering.

Følg disse trinnene for å oppdatere et arbeidsområde:

1. Gå til arbeidsområdet.
2. Velg kildekontrollikonet.
3. Velg Oppdateringer fra kildekontrollpanelet. En liste vises med alle elementene som ble endret i grenen siden forrige oppdatering.
4. Velg Oppdater alle.

Når den er oppdatert, fjernes listen over elementer, og arbeidsområdet peker til det nye arbeidsområdet som det er synkronisert til.

Når oppdateringen er fullført, endres statusen for elementene til Synkronisert.

Koble et arbeidsområde fra Git

Bare en administrator for arbeidsområdet kan koble fra et git-repositorium. Hvis du ikke er administrator, kan du be administratoren om hjelp med å koble fra. Hvis du er administrator og ønsker å koble fra repo, følger du disse trinnene:

1. Gå til innstillinger for arbeidsområde
2. Velg Git-integrasjon
3. Velg Koble fra arbeidsområde
4. Velg Koble fra på nytt for å bekrefte.

Tillatelser

Handlingene du kan utføre på et arbeidsområde, avhenger av tillatelsene du har i både arbeidsområdet og Git-repositoriet. Hvis du vil ha en mer detaljert diskusjon om tillatelser, kan du se Tillatelser.

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.

Begrensninger for Azure DevOps

• Azure DevOps-kontoen må være registrert for den samme brukeren som bruker Fabric-arbeidsområdet.
• Azure DevOps støttes ikke hvis Aktiver validering av policy for IP-betinget tilgang er aktivert.
• 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 konfigurerte betinget tilgang, må du kontrollere at Power BI-tjenesten har samme betingelser som er angitt for at godkjenning skal fungere som forventet.
• Utføringsstørrelsen er begrenset til 125 MB.

GitHub-begrensninger

• Bare skyversjoner av GitHub støttes. Lokal støttes ikke.
• GitHub kan ikke fremtvinge kryss-geo-valideringer.
• Den totale samlede størrelsen på filer som skal utføres samtidig, er begrenset til 50 MB. Hvis du har flere elementer å utføre, kan det noen ganger være nødvendig å dele dem inn i noen separate utføringer. Hvis du vil ha mer informasjon om hvordan du oppretter filer, kan du se feilsøkingsveiledningen vår.

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.

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.
• 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
• 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

• Forstå Git-integreringsprosessen
• Behandle Git-grener
• Anbefalte fremgangsmåter for Git-integrering