Del via

Grundlæggende begreber i Git-integration

  • Artikel

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

Tilladelser

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

  • Administrator: Kan udføre en hvilken som helst handling i arbejdsområdet, kun begrænset af deres Git-rolle.
  • Medlem/bidragyder: Når vedkommende opretter forbindelse til et arbejdsområde, kan et medlem/en bidragyder bekræfte og opdatere ændringer afhængigt af deres Git-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 administrator.
  • Fremviser: Der kan ikke udføres nogen handlinger. Fremviseren kan ikke se nogen Git-relaterede oplysninger i arbejdsområdet.

Arbejdsområderoller

I følgende tabel beskrives de tilladelser, der er nødvendige i Fabric-arbejdsområdet for at udføre forskellige almindelige handlinger:

Handling Arbejdsområderolle
Opret forbindelse mellem arbejdsområde og Git-lager Administrator
Synkroniser arbejdsområde med Git-lager Administrator
Afbryd forbindelsen mellem arbejdsområdet og Git-lageret Administrator
Skift forgrening i arbejdsområdet (eller enhver ændring i forbindelsesindstillingen) Administrator
Vis oplysninger om Git-forbindelse Administrator, medlem, bidragyder
Se arbejdsområdet 'Git-status' Administrator, medlem, bidragyder
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)
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)
Opret ny Git-forgrening inde fra Fabric Administrator
Forgrening til et nyt arbejdsområde Administrator, medlem, bidragyder

Git-roller

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

Handling Git-tilladelser
Opret forbindelse mellem arbejdsområde og Git-lager Læs=Tillad
Synkroniser arbejdsområde med Git-lager Læs=Tillad
Afbryd forbindelsen mellem arbejdsområdet og Git-lageret Der kræves ingen tilladelser
Skift forgrening i arbejdsområdet (eller enhver ændring i forbindelsesindstillingen) Read=Allow (i destinations repo/directory/branch)
Vis oplysninger om Git-forbindelse Læs eller Ingen
Se arbejdsområdet 'Git-status' Læs=Tillad
Opdatering fra Git Læs=Tillad
Udfør ændringer i arbejdsområdet i Git Læs=Tillad
Bidrag=Tillad
forgreningspolitik bør tillade direkte bekræftelse
Opret ny Git-forgrening inde fra Fabric Rolle=Skriv
Opret forgrening=Tillad
Forgrening til et nyt arbejdsområde Læs=Tillad
Opret forgrening=Tillad

Opret forbindelse, og synkroniser

Det er kun en administrator af arbejdsområdet, der kan oprette forbindelse mellem et arbejdsområde og et Git Repos, men når der er 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.

Skærmbillede af dialogboks, der spørger, hvilken retning der skal synkroniseres, hvis både Git og arbejdsområdet har indhold.

Hvis du ikke vælger, hvilket indhold der skal synkroniseres, kan du ikke fortsætte med at arbejde.

Skærmbillede, der viser, at du ikke kan fortsætte med at arbejde, før arbejdsområdet er synkroniseret.

Opret forbindelse til et delt arbejdsområde

Hvis du forsøger at oprette forbindelse til et arbejdsområde, der allerede har forbindelse til Git, får du muligvis vist følgende meddelelse:

Skærmbillede af fejlmeddelelse, der fortæller dig, at du skal logge på en Git-konto.

Gå til fanen Konti i højre side af kontrolpanelet Kilde, vælg en konto, og opret forbindelse til den.

Skærmbillede af fanen Konti med bruger, der opretter forbindelse til en GitHub-konto.

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.

Skærmbillede, hvis elementer i et arbejdsområde med deres Git-status er beskrevet.

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:

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

Skærmbillede af synkroniseringsoplysninger, der vises nederst på skærmen, når der er oprettet forbindelse til Git.

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 der foretages ændringer af enten arbejdsområdet eller git-forgreningen, opdateres tallet. Når arbejdsområdet er synkroniseret med forgreningen Git, vises der et 0 med ikonet Kildekontrolelement.

Skærmbillede af ikonet for kildekontrolelementet, der viser nul elementer, der er ændret.

Vælg ikonet Kildekontrolelement for at åbne kontrolpanelet Kilde.

Ruden med kildekontrolelementet har tre faner i siden:

Bekræftelser og opdateringer

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 kontrolpanelet Kilde.

Panelet Bekræft og opdater indeholder to sektioner.

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

I hvert afsnit vises de ændrede elementer med et ikon, der angiver status:

  • ny
  • Ændret
  • Slettet
  • konflikt

Knappen Opdater øverst i panelet opdaterer listen over ændringer og opdateringer.

Skærmbillede af kildekontrolpanelet, der viser status for de ændrede elementer.

Begå

  • Elementer i arbejdsområdet, der blev ændret, er angivet i sektionen Ændringer . Når der er mere end ét ændret element, 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.

Opdater

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

Forgreninger

Fanen Forgreninger i kontrolpanelet Kilde giver dig mulighed for at administrere dine forgreninger og udføre handlinger, der er relateret til forgreninger. Der er to hovedafsnit:

  • Handlinger, du kan foretage på den aktuelle forgrening:

    • Forgrening til nyt arbejdsområde (en hvilken som helst rolle): Opretter et nyt arbejdsområde og en ny forgrening baseret på den sidste bekræftelse af den forgrening, der er forbundet til det aktuelle arbejdsområde. Den opretter forbindelse til det nye arbejdsområde og den nye forgrening.
    • Udtjekning af ny forgrening (skal være arbejdsområdeadministrator): Opretter en ny forgrening, der er baseret på den senest synkroniserede bekræftelse i arbejdsområdet, og ændrer Git-forbindelsen i det aktuelle arbejdsområde. Det ændrer ikke indholdet i arbejdsområdet.
    • Skift forgrening (skal være arbejdsområdeadministrator): Synkroniserer arbejdsområdet med en anden ny eller eksisterende forgrening og tilsidesætter alle elementer i arbejdsområdet med indholdet af den valgte forgrening.

    Skærmbillede af fanen Forgrening i kontrolpanelet Kilde.

  • Relaterede forgreninger.
    Fanen Forgreninger indeholder også en liste over relaterede arbejdsområder, du kan vælge og skifte til. Et relateret arbejdsområde er et med de samme forbindelsesegenskaber som den aktuelle forgrening, f.eks. den samme organisation, det samme projekt, det samme lager og den samme git-mappe.
    Dette giver dig mulighed for at navigere til arbejdsområder, der er forbundet med andre forgreninger, der er relateret til konteksten for dit aktuelle arbejde, uden at skulle søge efter dem på listen over Fabric-arbejdsområder.
    Klik på et element på listen for at åbne det relevante arbejdsområde.

    Skærmbillede, der viser en liste over relaterede forgreninger, som brugeren kan skifte til.

Se Begrænsninger for forgrening for at få flere oplysninger.

Firmadetaljer

Fanen Kontooplysninger viser oplysninger om den GitHub-konto, som brugeren har forbindelse til. Det har to sektioner. I det øverste afsnit vises Git-udbyderen og kontonavnet. I nederste afsnit vises det lager og den forgrening, som arbejdsområdet har forbindelse til. I øjeblikket er denne fane kun tilgængelig for arbejdsområder, der er forbundet til GitHub.

GitHub-kontooplysninger omfatter:

  • Oplysninger om Git-konto

    • Udbyder
    • Firmanavn

  • Git-lager

  • Gren

Skærmbillede af fanen Konti i Kontrolpanel Kilde, der viser Git-oplysninger og lager- og forgreningsnavne.

Overvejelser og begrænsninger

Generelle begrænsninger for Git-integration

  • Godkendelsesmetoden i Fabric skal være mindst lige så stærk som godkendelsesmetoden for Git. Hvis Git f.eks. kræver multifaktorgodkendelse, skal Fabric også kræve multifaktorgodkendelse.
  • Power BI-datasæt, der er forbundet til Analysis Services, understøttes ikke i øjeblikket.
  • Arbejdsområder med skabelonapps, der er installeret, kan ikke oprettes forbindelse til Git.
  • Nationale cloudmiljøer understøttes ikke.
  • Azure DevOps-kontoen skal være registreret for den samme bruger, der bruger Fabric-arbejdsområdet.
  • Lejeradministratoren skal aktivere eksporter på tværs af geografiske områder, hvis arbejdsområdet og Git-lageret er i to forskellige geografiske områder.
  • Bekræftelsesstørrelsen er begrænset til 125 MB.

GitHub Enterprise-begrænsninger

Nogle GitHub Enterprise-indstillinger understøttes ikke. Eksempler:

Begrænsninger for arbejdsområde

  • Det er kun administratoren af arbejdsområdet, der kan administrere forbindelserne til Git-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.
  • Arbejdsområdets mappestruktur afspejles ikke i Git-lageret. Arbejdsområdeelementer i mapper eksporteres til rodmappen.

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.
  • Når du navngiver en mappe i Git, tilføjes det logiske id (GUID) som præfiks før typen, hvis elementets viste navn:
    • Indeholder mere end 256 tegn
    • Slutter med . eller et mellemrum
    • Indeholder et af følgende tegn: " / : ? < > \ * |

Begrænsninger for forgrening

  • Forgrening kræver tilladelser, der er angivet i tilladelsestabellen.
  • Der skal være en tilgængelig kapacitet til denne handling.
  • Alle begrænsninger for navngivning af arbejdsområder og forgreninger gælder, når du forgrener dig til et nyt arbejdsområde.
  • Når du forgrener dig, oprettes der et nyt arbejdsområde, og indstillingerne fra det oprindelige arbejdsområde kopieres ikke. Juster eventuelle indstillinger eller definitioner for at sikre, at det nye arbejdsområde opfylder organisationens politikker.
  • Det er kun Git-understøttede elementer , der er tilgængelige i det nye arbejdsområde.
  • Listen over relaterede forgreninger viser kun de forgreninger og arbejdsområder, du har tilladelse til at få vist.
  • Git-integration skal være aktiveret.

Begrænsninger for synkronisering og bekræftelse

  • 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. Elementer, der ikke understøttes i mappen, ignoreres.
  • Duplikering af navne er ikke tilladt. Selvom Power BI tillader duplikering af navne, mislykkes opdateringen, bekræftelsen eller fortrydelseshandlingen.
  • B2B understøttes ikke.
  • Konfliktløsning udføres delvist i Git.
  • Under Processen Bekræft til Git sletter Fabric-tjenesten filer i elementmappen, der ikke er en del af elementdefinitionen. Ikke-relaterede filer, der ikke findes i en elementmappe, slettes ikke.
  • Når du har bekræftet ændringerne, kan du opleve nogle uventede ændringer af det element, du ikke har foretaget. Disse ændringer er semantisk ubetydelige og kan ske af flere årsager. Eksempel:
    • Rediger elementdefinitionsfilen manuelt. Disse ændringer er gyldige, men kan være anderledes, end hvis de udføres via editorerne. Hvis du f.eks. omdøber en semantisk modelkolonne i Git og importerer denne ændring til arbejdsområdet, registreres bim-filen som ændret, næste gang du sender ændringer til den semantiske model, og den ændrede kolonne skubbes bagest i matrixencolumns. Dette skyldes, at det AS-program, der genererer bim-filerne , skubber omdøbte kolonner til slutningen af matrixen. Denne ændring påvirker ikke den måde, elementet fungerer på.
    • Bekræftelse af en fil, der bruger CRLF-linjeskift . Tjenesten bruger LF-linjeskift (linjeskift). Hvis du havde elementfiler i Git-lageret med CRLF-linjeskift , ændres disse filer til LF, når du bekræfter fra tjenesten. Hvis du f.eks. åbner en rapport på skrivebordet, skal du gemme .pbip-projektet og uploade det til Git ved hjælp af CRLF.
  • Opdatering af en semantisk model ved hjælp af API'en for udvidet opdatering medfører en Git-diff efter hver opdatering.

Relateret indhold