Del via

Hvad er Microsoft Fabric Git-integration?

  • Artikel

I denne artikel forklares det for udviklere, hvordan de integrerer Git-versionsstyring med ALM-værktøjet (Microsoft Fabric Application Lifecycle Management).

Bemærk

Nogle af elementerne til Git-integration er en prøveversion. Du kan få flere oplysninger på listen over understøttede elementer.

Git-integration i Microsoft Fabric gør det muligt for udviklere at integrere deres udviklingsprocesser, værktøjer og bedste praksis direkte i Fabric-platformen. Det giver udviklere, der udvikler i Fabric, mulighed for at:

  • Sikkerhedskopiér og version af deres arbejde
  • Vend tilbage til forrige faser efter behov
  • Samarbejd med andre, eller arbejd alene ved hjælp af Git-forgreninger
  • Anvend funktionerne i velkendte kildestyringsværktøjer til at administrere Fabric-elementer

Se listen over understøttede elementer.

Oplysninger om beskyttelse af personlige oplysninger

Før du aktiverer Git-integration, skal du kontrollere, at du gennemser følgende erklæringer om beskyttelse af personlige oplysninger:

Understøttede Git-providere

Følgende Git-providere understøttes:

Understøttede elementer

Følgende elementer understøtter i øjeblikket Git-integration:

  • Data engineering-elementer:

  • Data Factory-elementer:

  • Intelligence-elementer i realtid:

  • Data Warehouse-elementer:

    • #B0 Warehouse-#A1 #A2 (prøveversion) #C3

  • Power BI-elementer:

    • #B0 #C1 målepunkter
    • #A1 #A2 #A1 #A2 organisationsappen (prøveversion) #C3 #B0
    • #B0 sideinddelte #A1 #A2 (prøveversion) #C3
    • #B0 rapport #C1 (undtagen rapporter, der er forbundet med semantiske modeller, der hostes i #B2 Azure Analysis Services #A3 , #B4 SQL Server Analysis Services #A5 eller rapporter, der eksporteres af Power BI Desktop, og som er afhængige af semantiske modeller, der hostes i #B6 MyWorkspace #A7 ) #B8 (prøveversion) #C9
    • #B0 semantisk model #C1 (undtagen pushdatasæt, direkte forbindelser til Analysis Services, model v1) #B2 (prøveversion) #C3

  • Databaseelementer:

  • Brancheløsninger:

    • Sundhedspleje(prøveversion)
    • HealthCare Cohort #B0 (prøveversion) #C1

Hvis arbejdsområdet eller Git-mappen indeholder elementer, der ikke understøttes, kan det stadig være forbundet, men de elementer, der ikke understøttes, ignoreres. De gemmes eller synkroniseres ikke, men de slettes heller ikke. De vises i kildekontrolpanelet, men du kan ikke bekræfte eller opdatere dem.

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.
  • Undermoduler understøttes ikke.
  • Nationale cloudmiljøer understøttes ikke.

GitHub Enterprise-begrænsninger

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

  • IP-tilladelsesliste

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åder med skabelonapps, der er installeret, kan ikke oprettes forbindelse til Git.
  • MyWorkspace kan ikke oprette forbindelse til en Git-udbyder.

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.
  • Mappestrukturen vedligeholdes op til 10 niveauer dyb.
  • 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 har nogen af disse egenskaber, omdøbes mappen Git til det logiske id (GUID) og skriver:
  • Når du opretter forbindelse til et arbejdsområde, der har mapper til Git, skal du bekræfte ændringer i Git-lageret, hvis den mappestruktur, er anderledes.

Begrænsninger for mappenavn

  • Navnet på den mappe, der opretter forbindelse til Git-lageret, har følgende navngivningsbegrænsninger:

    • Mappenavnet kan ikke starte eller slutte med et mellemrum eller en fane.
    • Mappenavnet må ikke indeholde følgende tegn: "/:<>\*?|

  • Elementmappen (den mappe, der indeholder elementfilerne) må ikke indeholde følgende tegn: ":<>\*?|. Hvis du omdøber mappen til noget, der indeholder et af disse tegn, kan Git ikke oprette forbindelse til eller synkronisere med arbejdsområdet, og der opstår en fejl.

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.
  • 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.
  • Når du forgrener, oprettes der en ny forgrening, og indstillingerne fra den oprindelige forgrening kopieres ikke. Juster eventuelle indstillinger eller definitioner for at sikre, at den nye opfylder organisationens politikker.
  • Når du forgrener dig til et eksisterende arbejdsområde:
    • Destinationsarbejdsområdet skal understøtte en Git-forbindelse.
    • Brugeren skal være administrator af destinationsarbejdsområdet.
    • Målarbejdsområdet skal have kapacitet.
    • Arbejdsområdet kan ikke have skabelonapps.
  • Bemærk, at når du forgrener dig til et arbejdsområde, kan elementer, der ikke er gemt i Git, gå tabt. Vi anbefaler, at du bekræfte elementer, du vil beholde, før du forgrener dig.

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 projektfilen (.pbip) og uploade den 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