Grundlæggende begreber i Git-integration

I denne artikel forklares de grundlæggende Git-begreber og processen med at integrere Git med dit Microsoft Fabric-arbejdsområde.

Vigtigt

Denne funktion er en prøveversion.

Tilladelser

Azure DevOps-tilladelser

På følgende liste kan du se, hvad forskellige arbejdsområderoller kan gøre, afhængigt af deres Azure DevOps-tilladelser:

  • Administration: Kan udføre en hvilken som helst handling i arbejdsområdet, kun begrænset af deres Azure DevOps-rolle.
  • Medlem/bidragyder: Når der er oprettet forbindelse til et arbejdsområde, kan et medlem/en bidragyder bekræfte og opdatere ændringer, afhængigt af deres Azure DevOps-rolle. I forbindelse med handlinger, der er relateret til arbejdsområdeforbindelsen (f.eks. opret forbindelse, afbryd forbindelsen eller skift forgreninger), skal du søge efter hjælp fra en Administration.
  • Fremviser: Der kan ikke udføres nogen handlinger. Fremviseren kan ikke se nogen Git-relaterede oplysninger i arbejdsområdet.

Tilladelser, der er nødvendige for almindelige handlinger

I følgende tabel beskrives de tilladelser, der er nødvendige for at udføre forskellige almindelige handlinger:

Handling Arbejdsområderolle Git-tilladelser
Forbind arbejdsområde til Git-lager Administration Læs=Tillad
Synkroniser arbejdsområde med Git-lager Administration Læs=Tillad
Afbryd forbindelsen mellem arbejdsområdet og Git-lageret Administration Der kræves ingen tilladelser
Skift forgrening i arbejdsområdet (eller enhver ændring i forbindelsesindstillingen) Administration Read=Allow (i destinations repo/directory/branch)
Vis oplysninger om Git-forbindelse Administration, Medlem, Bidragyder Læs eller Ingen
Se arbejdsområdet 'Git-status' Administration, Medlem, Bidragyder Læs=Tillad
Opdatering fra Git Alle af følgende:

Bidragyder i arbejdsområdet (skrivetilladelse til alle elementer)

Ejer af elementet (hvis lejerkontakten blokerer opdateringer for ikke-ejere)

BUILD på eksterne afhængigheder (hvor det er relevant)
Læs=Tillad
Udfør ændringer i arbejdsområdet i Git Alle af følgende:

Bidragyder i arbejdsområdet (skrivetilladelse til alle elementer)

Ejer af elementet (hvis lejerkontakten blokerer opdateringer for ikke-ejere)

BUILD på eksterne afhængigheder (hvor det er relevant)
Læs=Tillad
Bidrag=Tillad
forgreningspolitik bør tillade direkte bekræftelse
Opret ny Git-forgrening inde fra Fabric Administration Rolle=Skriv
Opret forgrening=Tillad

Forbind og synkroniser

Det er kun en administrator af arbejdsområdet, der kan oprette forbindelse mellem et arbejdsområde og Azure Repos, men når du har oprettet forbindelse, kan alle med tilladelser arbejde i arbejdsområdet. Hvis du ikke er administrator, kan du bede din administrator om hjælp til at oprette forbindelse.

Når du opretter forbindelse mellem et arbejdsområde og Git, synkroniseres Fabric mellem de to placeringer, så de har det samme indhold. Hvis enten arbejdsområdet eller Git-forgreningen er tom under denne indledende synkronisering, mens den anden har indhold, kopieres indholdet fra den ikke-tomme placering til den tomme. Hvis både arbejdsområdet og Git-forgreningen har indhold, skal du beslutte, i hvilken retning synkroniseringen skal gå.

  • Hvis du sender dit arbejdsområde til git-forgreningen, eksporteres alt understøttet arbejdsområdeindhold til Git og overskriver det aktuelle Git-indhold.
  • Hvis du opdaterer arbejdsområdet med Git-indholdet, overskrives indholdet i arbejdsområdet, og du mister dit arbejdsområdeindhold. Da en Git-forgrening altid kan gendannes til en tidligere fase, mens et arbejdsområde ikke kan, bliver du bedt om at bekræfte, hvis du vælger denne indstilling.

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

Hvis du ikke vælger, hvilket indhold der skal synkroniseres, kan du ikke fortsætte med at arbejde, før du gør det:

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

Git-status

Når du har oprettet forbindelse, viser arbejdsområdet en Git-statuskolonne , der angiver synkroniseringstilstanden for hvert element i arbejdsområdet i forhold til elementerne i fjerngrenen.

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

Hvert element har en af følgende statusser:

  • Synkroniseret (elementet er det samme i arbejdsområdet og Git-forgreningen)
  • Konflikt (elementet blev ændret i både arbejdsområdet og Git-forgreningen)
  • Element, der ikke understøttes
  • Ikke-bekræftede ændringer i arbejdsområdet
  • Opdatering kræves fra Git
  • Elementet er identisk begge steder, men skal opdateres til den seneste bekræftelse

Synkroniseringsoplysninger

Så længe du har forbindelse, vises følgende oplysninger nederst på skærmen:

  • Forbind forgrening
  • Tidspunkt for seneste synkronisering
  • Link til den seneste bekræftelse, som arbejdsområdet er synkroniseret med

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

Bekræftelser og opdateringer

Ruden Kildekontrolelement

Øverst på skærmen er ikonet Kildekontrolelement. Det viser antallet af elementer, der er forskellige i arbejdsområdet og Git-forgreningen. Når arbejdsområdet er synkroniseret med forgreningen Git, vises der et 0 med ikonet Kildekontrolelement.

Screenshot of the source control icon showing zero items changed.

Når der foretages ændringer af enten arbejdsområdet eller git-forgreningen, viser ikonet for kildekontrolelementet antallet af elementer, der er forskellige. Vælg ikonet for kildekontrolelementet for at åbne ruden Kildekontrolelement.

I ruden Kildekontrol viser fanen Ændringer antallet af elementer, der er ændret i arbejdsområdet, og som skal bekræftes i Git, og fanen Opdateringer viser antallet af elementer, der er ændret i forgreningen Git og skal opdateres til arbejdsområdet.

Under hver fane vises de ændrede elementer med et ikon, der angiver status:

  • Nye
  • Ændret
  • Slettet
  • Konflikt

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

Begå

  • Når der er mere end ét element at bekræfte, kan du vælge, hvilke elementer der skal bekræftes i git-forgreningen.
  • Hvis der blev foretaget opdateringer af Git-forgreningen, deaktiveres bekræftelser, indtil du opdaterer dit arbejdsområde.

Opdatér

  • I modsætning til bekræftelse og fortryd opdaterer kommandoen Opdater altid hele forgreningen og synkroniserer til den seneste bekræftelse. Du kan ikke vælge bestemte elementer, der skal opdateres.
  • Hvis der er foretaget ændringer i arbejdsområdet og i forgreningen Git for det samme element, deaktiveres opdateringer, indtil konflikten er løst.

Læs mere om, hvordan du bekræfter og opdaterer. Læs mere om opdateringsprocessen, og hvordan du løser konflikter.

Overvejelser og begrænsninger

Generelle begrænsninger

  • Azure DevOps-kontoen skal være registreret for den samme bruger, der bruger Fabric-arbejdsområdet.
  • Godkendelsesmetoden i Power BI skal være mindst lige så stærk som godkendelsesmetoden for Azure DevOps. Hvis Azure DevOps f.eks. kræver multifaktorgodkendelse, skal Power BI også kræve multifaktorgodkendelse.
  • Direct Query og sammensatte modeller på Power BI-datasæt og Analysis Services understøttes ikke i øjeblikket.
  • DirectLake-semantiske modeller understøttes ikke i øjeblikket.
  • Opdatering af en semantisk model ved hjælp af API'en for udvidet opdatering medfører en Git-diff efter hver opdatering.

Begrænsninger for arbejdsområde

Det er kun administratoren af arbejdsområdet, der kan administrere forbindelserne til Azure-lageret , f.eks. oprette forbindelse, afbryde forbindelsen eller tilføje en forgrening. Når du har oprettet forbindelse, kan alle med tilladelse arbejde i arbejdsområdet.

Begrænsninger for forgreninger og mapper

  • Den maksimale længde på forgreningsnavnet er 244 tegn.

  • Den maksimale længde på den fulde sti til filnavne er 250 tegn. Længere navne mislykkes.

  • Den maksimale filstørrelse er 25 MB.

  • Du kan ikke downloade en rapport/et datasæt som .pbix fra tjenesten, når du har udrullet dem med Git-integration.

  • Hvis elementets viste navn:

    • Indeholder mere end 256 tegn
    • Slutter med .' eller et mellemrum
    • Indeholder et af følgende tegn: ", /, :, <, >, \\, *, ?|

    Det logiske id (GUID) tilføjes som et præfiks før typen, når mappen navngives i Git.

Begrænsninger for synkronisering og bekræftelse

  • Størrelsesgrænsen for en bekræftelse er 125 MB.
  • Du kan kun synkronisere i én retning ad gangen. Du kan ikke bekræfte og opdatere på samme tid.
  • Følsomhedsmærkater understøttes ikke, og eksport af elementer med følsomhedsmærkater kan være deaktiveret. Hvis du vil bekræfte elementer, der har følsomhedsmærkater uden følsomhedsmærkaten, skal du bede administratoren om hjælp.
  • Fungerer sammen med begrænsede elementer. Hvis elementer, der ikke understøttes, findes i mappen, ignoreres de.
  • Duplikering af navne er ikke tilladt – selvom Power BI tillader det, mislykkes opdateringen, bekræftelsen eller fortrydelseshandlingen.
  • B2B understøttes ikke.
  • Konfliktløsning udføres delvist i Git.