Grunnleggende konsepter i Git-integrasjon

Denne artikkelen forklarer grunnleggende Git-konsepter og prosessen med å integrere Git med Microsoft Fabric-arbeidsområdet.

Viktig

Denne funksjonen er i forhåndsvisning.

Tillatelser

Azure DevOps-tillatelser

Listen nedenfor viser hva ulike arbeidsområderoller kan gjøre, avhengig av Azure DevOps-tillatelsene:

  • Administrator: Kan utføre en hvilken som helst operasjon på arbeidsområdet, begrenset bare av Azure DevOps-rollen.
  • Medlem/bidragsyter: Når de er koblet til et arbeidsområde, kan et medlem/bidragsyter utføre og oppdatere endringer, avhengig av Azure DevOps-rollen. For handlinger relatert til arbeidsområdetilkoblingen (for eksempel koble til, koble fra eller bytte grener) kan du søke hjelp fra en administrator.
  • Visningsprogram: Kan ikke utføre noen handlinger. Visningsprogrammet kan ikke se git-relatert informasjon i arbeidsområdet.

Tillatelser som kreves for vanlige operasjoner

Tabellen nedenfor beskriver tillatelsene som kreves for å utføre ulike vanlige operasjoner:

Operasjon Arbeidsområderolle Git-tillatelser
Koble til arbeidsområde til Git-repositorium Administrator Les=Tillat
Synkroniser arbeidsområde med Git-repositorium Administrator Les=Tillat
Koble arbeidsområde fra Git-repositorium Administrator Ingen tillatelser er nødvendig
Bytt gren i arbeidsområdet (eller endringer i tilkoblingsinnstillingen) Administrator Read=Tillat (i mål-repo/katalog/gren)
Vis git-tilkoblingsdetaljer Administrator, medlem, bidragsyter Lese eller ingen
Se git-status for arbeidsområdet Administrator, medlem, bidragsyter Les=Tillat
Oppdater fra Git Alt dette:

Bidragsyter i arbeidsområdet (SKRIVE-tillatelse på alle elementer)

Eier av elementet (hvis leierbryteren blokkerer oppdateringer for ikke-eiere)

BYGG på eksterne avhengigheter (der det er aktuelt)
Les=Tillat
Utfør arbeidsområdeendringer til Git Alt dette:

Bidragsyter i arbeidsområdet (SKRIVE-tillatelse på alle elementer)

Eier av elementet (hvis leierbryteren blokkerer oppdateringer for ikke-eiere)

BYGG på eksterne avhengigheter (der det er aktuelt)
Les=Tillat
Bidra=Tillat
grenpolicy bør tillate direkte utføring
Opprett ny Git-gren fra Fabric Administrator Rolle=Skriv
Opprett gren=Tillat

Koble til og synkroniser

Bare en arbeidsområdeadministrator kan koble et arbeidsområde til Azure Repos, men når de er tilkoblet, kan alle med tillatelser arbeide i arbeidsområdet. Hvis du ikke er administrator, kan du be administratoren om hjelp med å koble til.

Når du kobler et arbeidsområde til Git, synkroniseres Fabric mellom de to plasseringene, slik at de har samme innhold. Under denne første synkroniseringen, hvis enten arbeidsområdet eller Git-grenen er tom mens den andre har innhold, kopieres innholdet fra den ikke-tomme plasseringen til den tomme. Hvis både arbeidsområdet og Git-grenen har innhold, må du bestemme hvilken retning synkroniseringen skal gå.

  • Hvis du forplikter arbeidsområdet til Git-grenen, eksporteres alt støttet arbeidsområdeinnhold til Git og overskriver gjeldende Git-innhold.
  • Hvis du oppdaterer arbeidsområdet med Git-innholdet, overskrives innholdet i arbeidsområdet, og du mister innholdet i arbeidsområdet. Siden en Git-gren alltid kan gjenopprettes til en tidligere fase, mens et arbeidsområde ikke kan gjøre det, blir du bedt om å bekrefte hvis du velger dette alternativet.

Screenshot of dialog asking which direction to sync if both Git and the workspace have content.

Hvis du ikke velger hvilket innhold du vil synkronisere, kan du ikke fortsette å arbeide før du gjør dette:

Screenshot notification that you can't continue working until workspace is synced.

Git-status

Når du har koblet til, viser arbeidsområdet en Git-statuskolonne som angir synkroniseringstilstanden for hvert element i arbeidsområdet i forhold til elementene i den eksterne grenen.

Screenshot if items in a workspace with their Git status outlined.

Hvert element har én av følgende statuser:

  • Synkronisert (elementet er det samme i arbeidsområdet og Git-grenen)
  • Konflikt (elementet ble endret i både arbeidsområdet og Git-grenen)
  • Element som ikke støttes
  • Uforpliktende endringer i arbeidsområdet
  • Oppdatering kreves fra Git
  • Elementet er identisk begge steder, men må oppdateres til siste utføring

Synkroniseringsinformasjon

Så lenge du er tilkoblet, vises følgende informasjon nederst på skjermen:

  • Koble til gren
  • Tidspunktet for siste synkronisering
  • Kobling til siste utføring som arbeidsområdet er synkronisert til

Screenshot of sync information that appears on the bottom of the screen when connected to Git.

Utføringer og oppdateringer

Kildekontrollrute

Øverst på skjermen finner du kildekontrollikonet. Den viser antall elementer som er forskjellige i arbeidsområdet og Git-grenen. Når arbeidsområdet synkroniseres med Git-grenen, viser kildekontrollikonet en 0.

Screenshot of the source control icon showing zero items changed.

Når det gjøres endringer i arbeidsområdet eller Git-grenen, viser kildekontrollikonet antall elementer som er forskjellige. Velg kildekontrollikonet for å åpne kildekontrollruten.

Fanen Endringer i kildekontrollruten viser antall elementer som ble endret i arbeidsområdet, og må være forpliktet til Git, og fanen Oppdateringer viser antall elementer som ble endret i Git-grenen, og må oppdateres til arbeidsområdet.

I hver fane vises de endrede elementene med et ikon som angir statusen:

  • Nye
  • Endret
  • Slettet
  • Konflikt

Screenshot of the source control panel showing the status of the changed items.

Begå

  • Når det er mer enn ett element å utføre, kan du velge hvilke elementer som skal utføres i Git-grenen.
  • Hvis det ble gjort oppdateringer i Git-grenen, deaktiveres utføringer til du oppdaterer arbeidsområdet.

Oppdater

  • I motsetning til utføring og angre, oppdaterer Oppdater-kommandoen alltid hele grenen og synkroniserer til den nyeste utførelsen. Du kan ikke velge bestemte elementer som skal oppdateres.
  • Hvis det ble gjort endringer i arbeidsområdet og i Git-grenen på samme element, deaktiveres oppdateringer til konflikten er løst.

Les mer om hvordan du utfører og oppdaterer. Les mer om oppdateringsprosessen og hvordan du løser konflikter.

Hensyn og begrensninger

Generelle begrensninger

  • Azure DevOps-kontoen må være registrert for den samme brukeren som bruker Fabric-arbeidsområdet.
  • Godkjenningsmetoden i Power BI må være minst like sterk som godkjenningsmetoden for Azure DevOps. Hvis Azure DevOps for eksempel krever godkjenning med flere faktorer, må Power BI også kreve godkjenning med flere faktorer.
  • Direktespørring og sammensatte modeller på Power BI-datasett og Analysis Services støttes ikke for øyeblikket.
  • DirectLake-semantiske modeller støttes ikke for øyeblikket.
  • Oppdatering av en semantisk modell ved hjelp av API-en for forbedret oppdatering forårsaker en Git-diff etter hver oppdatering.

Arbeidsområdebegrensninger

Bare administratoren for arbeidsområdet kan administrere tilkoblingene til Azure Repo , 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.

  • 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 mer enn 256 tegn
    • Slutter med .' eller et mellomrom
    • Inneholder ett av følgende tegn: ", , /, :, <>, \\, *, , ?|

    Den logiske IDen (GUID) legges til som et prefiks før typen, når du navngir mappen i Git.

Synkroniser og utfør begrensninger

  • Størrelsesgrensen for en utføring er 125 MB.
  • 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. Hvis elementer som ikke støttes, er i mappen, ignoreres de.
  • Duplisering av navn er ikke tillatt – selv om Power BI tillater det, mislykkes oppdateringen, utføringen eller angrehandlingen.
  • B2B støttes ikke.
  • Konfliktløsning utføres delvis i Git.