Administrer et arbejdsområde med Git (prøveversion)

  • Artikel

I denne artikel gennemgås følgende grundlæggende opgaver i Git-integrationsværktøjet til Microsoft Fabric:

Det anbefales at læse oversigten over Git-integration , før du begynder.

Vigtigt

Denne funktion er en prøveversion.

Forudsætninger

Hvis du vil integrere Git med dit Microsoft Fabric-arbejdsområde, skal du konfigurere følgende forudsætninger i både Azure DevOps og Fabric.

Azure DevOps-forudsætninger

  • En aktiv Azure-konto, der er registreret for den samme bruger, som bruger Fabric-arbejdsområdet. Opret en gratis konto.
  • Adgang til et eksisterende lager.

Stofforudsætninger

Hvis du vil have adgang til git-integrationsfunktionen, skal du bruge et af følgende:

  • Power BI Premium-licens. En Power BI Premium-licens understøtter kun alle Power BI-elementer.
  • Stofkapacitet. Der kræves en Fabric-kapacitet for at bruge alle understøttede Fabric-elementer.

Derudover skal organisationens administrator aktivere lejeren Brugere kan oprette Fabric-elementer fra Administration-portalen.

Skærmbillede af Fabric-switch aktiveret.

Forbind et arbejdsområde til et Azure-lager

Det er kun en administrator af arbejdsområdet, der kan oprette forbindelse mellem et arbejdsområde og et Azure-lager, men når der er oprettet forbindelse, kan alle med tilladelse arbejde i arbejdsområdet. Hvis du ikke er administrator, kan du bede din administrator om hjælp til at oprette forbindelse. Hvis du vil oprette forbindelse mellem et arbejdsområde og et Azure-lager, skal du følge disse trin:

  1. Log på Power BI, og naviger til det arbejdsområde, du vil oprette forbindelse til.

  2. Gå til indstillinger for arbejdsområde

    Skærmbillede af arbejdsområdet med ikonet indstillinger for arbejdsområdet, der vises øverst.

    Bemærk

    Hvis du ikke kan se ikonet Indstillinger for arbejdsområde, skal du vælge ellipsen (tre prikker) og derefter indstillinger for arbejdsområdet. Skærmbillede af arbejdsområdet med linket indstillinger for arbejdsområdet, der vises fra ellipsen.

  3. Vælg Git-integration. Du er automatisk logget på den Azure Repos-konto, der er registreret for den Microsoft Entra-bruger, der er logget på Fabric.

    Skærmbillede af vinduet indstillinger for arbejdsområde med Git-integration valgt.

  4. I rullemenuen skal du angive følgende oplysninger om den forgrening, du vil oprette forbindelse til:

    Bemærk

    Du kan kun oprette forbindelse mellem et arbejdsområde og én forgrening og én mappe ad gangen.

    • Organisation
    • Projekt
    • Git-lager
    • Forgrening (vælg en eksisterende forgrening ved hjælp af rullemenuen, eller vælg + Ny forgrening for at oprette en ny forgrening. Du kan kun oprette forbindelse til én forgrening ad gangen.)
    • Mappe (vælg en eksisterende mappe i forgreningen, eller angiv et navn for at oprette en ny mappe. Hvis du ikke vælger en mappe, oprettes der indhold i rodmappen. Du kan kun oprette forbindelse til én mappe ad gangen.)

  5. Vælg Forbind, og synkroniser.

Hvis enten arbejdsområdet eller Git-forgreningen er tom under den indledende synkronisering, kopieres indhold fra den ikke-tomme placering til den tomme. Hvis både arbejdsområdet og Git-forgreningen har indhold, bliver du spurgt, i hvilken retning synkroniseringen skal gå. Du kan få flere oplysninger om denne indledende synkronisering under Forbind og synkroniser.

Når du har oprettet forbindelse, viser arbejdsområdet oplysninger om kildekontrol, der giver brugeren mulighed for at få vist den forbundne forgrening, status for hvert element i forgreningen og tidspunktet for den seneste synkronisering.

Skærmbillede af ikonet for kildestyring og andre Git-oplysninger.

Hvis du vil holde dit arbejdsområde synkroniseret med forgreningen Git, skal du bekræfte de ændringer, du foretager i arbejdsområdet, i forgreningen Git og opdatere dit arbejdsområde, når nogen opretter nye bekræftelser til Git-forgreningen.

Send ændringer til git

Når du har oprettet forbindelse til en Git-mappe, skal du redigere dit arbejdsområde som normalt. De ændringer, du gemmer, gemmes kun i arbejdsområdet. Når du er klar, kan du bekræfte dine ændringer i forgreningen Git, eller du kan fortryde ændringerne og vende tilbage til den forrige status. Læs mere om bekræftelser.

Følg disse trin for at bekræfte dine ændringer i git-forgreningen:

  1. Gå til arbejdsområdet.

  2. Vælg ikonet Kildekontrolelement . Dette ikon viser antallet af ændringer, der ikke er gemt. Skærmbillede af ikonet for kildekontrolelementet med tallet 2, der angiver, at der er to ændringer, der skal bekræftes.

  3. Vælg fanen Ændringer i ruden Kildekontrolelement . Der vises en liste med alle de elementer, du har ændret, og et ikon, der angiver, om elementet er nyt , ændret , konflikt eller slettet .

  4. Vælg de elementer, du vil bekræfte. Hvis du vil markere alle elementer, skal du markere det øverste afkrydsningsfelt.

  5. Tilføj en kommentar i feltet. Hvis du ikke tilføjer en kommentar, tilføjes der automatisk en standardmeddelelse.

  6. Vælg Bekræft.

    Skærmbillede af vinduet kildekontrolelement med to ændringer valgt for at bekræfte.

Når ændringerne er bekræftet, fjernes de elementer, der blev bekræftet, fra listen, og arbejdsområdet peger på den nye bekræftelse, som den er synkroniseret med.

Skærmbillede af vinduet kildekontrolelement, der angiver, at der ikke er nogen ændringer at bekræfte.

Når bekræftelsen er fuldført, ændres status for de valgte elementer fra Ikke gemt til Synkroniseret.

Opdater arbejdsområde fra Git

Når nogen bekræfter en ny ændring af den forbundne Git-forgrening, vises der en meddelelse i det relevante arbejdsområde. Brug ruden Kildekontrolelement til at trække de seneste ændringer, flette eller vende tilbage til arbejdsområdet og opdatere dynamiske elementer. Læs mere om opdatering.

Følg disse trin for at opdatere et arbejdsområde:

  1. Gå til arbejdsområdet.
  2. Vælg ikonet Kildekontrolelement .
  3. Vælg fanen Opdateringer i ruden Kildekontrolelement. Der vises en liste med alle de elementer, der er ændret i forgreningen siden sidste opdatering.
  4. Vælg Opdater alle.

Skærmbillede af ruden kildekontrolelement, hvor opdateringsfanen er åben, og knappen Opdater alle er valgt.

Når den er opdateret, fjernes listen over elementer, og arbejdsområdet peger på den nye bekræftelse, som den er synkroniseret med.

Skærmbillede af vinduet kildekontrolelement, der angiver, at du har opdateret arbejdsområdet.

Når opdateringen er fuldført, ændres status for elementerne til Synkroniseret.

Afbryd forbindelsen mellem et arbejdsområde og Git

Det er kun en administrator af arbejdsområdet, der kan afbryde forbindelsen mellem et arbejdsområde og et Azure-lager. Hvis du ikke er administrator, skal du bede din administrator om hjælp til at afbryde forbindelsen. Hvis du er administrator og vil afbryde forbindelsen til dit lager, skal du følge disse trin:

  1. Gå til indstillinger for arbejdsområde

  2. Vælg Git-integration

  3. Vælg Afbryd forbindelse til arbejdsområde

    Skærmbillede af skærmbilledet med indstillinger for arbejdsområde med indstillingen Afbryd forbindelsen til arbejdsområdet.

  4. Vælg Afbryd forbindelsen igen for at bekræfte.

    Skærmbillede af skærmbilledet med indstillinger for arbejdsområde, hvor du bliver spurgt, om du er sikker på, at du vil afbryde forbindelsen.

Tilladelser

De handlinger, du kan foretage på et arbejdsområde, afhænger af de tilladelser, du har i både arbejdsområdet og Azure DevOps. Du kan finde en mere detaljeret beskrivelse af tilladelser under Tilladelser.

Overvejelser og begrænsninger

  • Under Processen Bekræft til Git sletter Fabric-tjenesten alle 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. Eksempler:

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

  • Hvis du har problemer med disse handlinger, skal du sørge for at forstå begrænsningerne i git-integrationsfunktionen.

Relateret indhold