Kom igång med Git-integrering

Den här artikeln beskriver följande grundläggande uppgifter i Microsoft Fabrics Git-integreringsverktyg:

• Ansluta till en Git-lagringsplats
• Checka in ändringar
• Uppdatera från Git
• Koppla från Git

Vi rekommenderar att du läser översikten över Git-integrering innan du börjar.

Förutsättningar

För att integrera Git med din Microsoft Fabric-arbetsyta måste du konfigurera följande krav för både Fabric och Git.

Krav för infrastrukturresurser

För att få åtkomst till Git-integreringsfunktionen behöver du något av följande:

• Power BI Premium-licens. En Power BI Premium-licens stöder endast alla Power BI-objekt.
• Infrastrukturkapacitet. En infrastrukturresurskapacitet krävs för att använda alla infrastrukturresurser som stöds. Om du inte har någon ännu kan du registrera dig för en kostnadsfri utvärderingsversion.

Dessutom måste följande klientväxlar aktiveras från administratörsportalen:

• Användare kan skapa infrastrukturobjekt
• Användare kan synkronisera arbetsyteobjekt med sina Git-lagringsplatser
• Endast för GitHub-användare: Användare kan synkronisera arbetsyteobjekt med GitHub-lagringsplatser

Dessa växlar kan aktiveras av klientorganisationens administratör, kapacitetsadministratör eller arbetsyteadministratör, beroende på organisationens inställningar.

Git-krav

Git-integrering stöds för närvarande för Azure DevOps och GitHub. Om du vill använda Git-integrering med din Infrastruktur-arbetsyta behöver du följande i Antingen Azure DevOps eller GitHub:

Ansluta en arbetsyta till en Git-lagringsplats

Ansluta till en Git-lagringsplats

Endast en arbetsyteadministratör kan ansluta en arbetsyta till en lagringsplats, men när den är ansluten kan alla med behörighet arbeta på arbetsytan. Om du inte är administratör ber du administratören om hjälp med att ansluta. Följ dessa steg för att ansluta en arbetsyta till en Azure- eller GitHub-lagringsplats:

1. Logga in på Infrastrukturresurser och navigera till den arbetsyta som du vill ansluta till.

2. Gå till Inställningar för arbetsyta

   

3. Välj Git-integrering.

4. Välj din Git-provider. För närvarande stöds Azure DevOps och GitHub.

Anslut till en arbetsyta

Om arbetsytan redan är ansluten till GitHub följer du anvisningarna för Att ansluta till en delad arbetsyta.

Välj Anslut och synkronisera.

Om arbetsytan eller Git-grenen är tom under den inledande synkroniseringen kopieras innehållet från den icke-tillfälliga platsen till den tomma. Om både arbetsytan och Git-grenen har innehåll tillfrågas du om vilken riktning synkroniseringen ska gå. Mer information om den här inledande synkroniseringen finns i Ansluta och synkronisera.

När du har anslutit visar arbetsytan information om källkontroll som gör att användaren kan visa den anslutna grenen, status för varje objekt i grenen och tidpunkten för den senaste synkroniseringen.

Om du vill att arbetsytan ska synkroniseras med Git-grenen genomför du alla ändringar du gör i arbetsytan till Git-grenen och uppdaterar arbetsytan när någon skapar nya incheckningar till Git-grenen.

Checka in ändringar i git

När du har anslutit till en Git-mapp redigerar du arbetsytan som vanligt. Alla ändringar som du sparar sparas endast på arbetsytan. När du är klar kan du checka in ändringarna i Git-grenen eller ångra ändringarna och återgå till den tidigare statusen. Läs mer om incheckningar.

Uppdatera arbetsytan från Git

När någon genomför en ny ändring av den anslutna Git-grenen visas ett meddelande på den relevanta arbetsytan. Använd kontrollpanelen Källa för att hämta de senaste ändringarna, sammanfogar eller återställer till arbetsytan och uppdaterar liveobjekt. Läs mer om uppdatering.

Följ dessa steg för att uppdatera en arbetsyta:

1. Gå till arbetsytan.
2. Välj ikonen Källkontroll.
3. Välj Uppdateringar på kontrollpanelen Källa. En lista visas med alla objekt som har ändrats i grenen sedan den senaste uppdateringen.
4. Välj Uppdatera alla.

När den har uppdaterats tas listan över objekt bort och arbetsytan pekar på den nya incheckningen som den synkroniseras till.

När uppdateringen har slutförts ändras statusen för objekten till Synkroniserad.

Koppla från en arbetsyta från Git

Endast en arbetsyteadministratör kan koppla från en arbetsyta från en Git-lagringsplats. Om du inte är administratör ber du administratören om hjälp med att koppla från. Om du är administratör och vill koppla från lagringsplatsen följer du dessa steg:

1. Gå till Inställningar för arbetsyta
2. Välj Git-integrering
3. Välj Koppla från arbetsyta
4. Bekräfta genom att välja Koppla från igen.

Behörigheter

Vilka åtgärder du kan vidta på en arbetsyta beror på vilka behörigheter du har på både arbetsytan och Git-lagringsplatsen. En mer detaljerad beskrivning av behörigheter finns i Behörigheter.

Beaktanden och begränsningar

Allmänna begränsningar för Git-integrering

• Autentiseringsmetoden i Infrastrukturresurser måste vara minst lika stark som autentiseringsmetoden för Git. Om Git till exempel kräver multifaktorautentisering måste Fabric också kräva multifaktorautentisering.
• Power BI-datauppsättningar som är anslutna till Analysis Services stöds inte just nu.
• Arbetsytor med mallappar installerade kan inte anslutas till Git.
• Nationella moln stöds inte.

Begränsningar för GitHub Enterprise

Vissa GitHub Enterprise-inställningar stöds inte. Till exempel:

• LISTA över TILLÅTNA IP-adresser
• Privata nätverk
• Anpassade domäner

Begränsningar för arbetsyta

• Endast arbetsytans administratör kan hantera anslutningarna till Git-lagringsplatsen, till exempel ansluta, koppla från eller lägga till en gren.
  När den är ansluten kan alla med behörighet arbeta på arbetsytan.
• Arbetsytans mappstruktur återspeglas inte i Git-lagringsplatsen. Arbetsyteobjekt i mappar exporteras till rotkatalogen.

Begränsningar för gren och mapp

• Maximal längd på grennamnet är 244 tecken.
• Maximal längd på fullständig sökväg för filnamn är 250 tecken. Längre namn misslyckas.
• Maximal filstorlek är 25 MB.
• Du kan inte ladda ned en rapport/datauppsättning som .pbix från tjänsten när du har distribuerat dem med Git-integrering.
• När du namnger en mapp i Git läggs det logiska ID:t (Guid) till som ett prefix före typen om objektets visningsnamn:
  • Har fler än 256 tecken
  • Slutar med . eller ett blanksteg
  • Innehåller något av följande tecken: " / : ? < > \ * |

Förgrena begränsningar

• Förgrening kräver behörigheter som anges i behörighetstabellen.
• Det måste finnas en tillgänglig kapacitet för den här åtgärden.
• Alla begränsningar för namngivning av arbetsyta och gren gäller när du förgrenar till en ny arbetsyta.
• När du förgrenar ut skapas en ny arbetsyta och inställningarna från den ursprungliga arbetsytan kopieras inte. Justera eventuella inställningar eller definitioner för att säkerställa att den nya arbetsytan uppfyller organisationens principer.
• Endast Git-objekt som stöds är tillgängliga på den nya arbetsytan.
• Listan med relaterade grenar visar bara grenar och arbetsytor som du har behörighet att visa.
• Git-integrering måste vara aktiverat.

Begränsningar för synkronisering och incheckning

• Du kan bara synkronisera i en riktning i taget. Du kan inte checka in och uppdatera samtidigt.
• Känslighetsetiketter stöds inte och export av objekt med känslighetsetiketter kan inaktiveras. Om du vill checka in objekt som har känslighetsetiketter utan känslighetsetiketten ber du administratören om hjälp.
• Fungerar med begränsade objekt. Objekt som inte stöds i mappen ignoreras.
• Duplicering av namn tillåts inte. Även om Power BI tillåter namnduplicering misslyckas åtgärden uppdatera, checka in eller ångra.
• B2B stöds inte.
• Konfliktlösningen görs delvis i Git.
• Under incheckningen till Git-processen tar Fabric-tjänsten bort filer i objektmappen som inte ingår i objektdefinitionen. Orelaterade filer som inte finns i en objektmapp tas inte bort.
• När du har checkat in ändringar kan du märka några oväntade ändringar i objektet som du inte gjorde. Dessa ändringar är semantiskt obetydliga och kan inträffa av flera skäl. Till exempel:
  • Ändra objektdefinitionsfilen manuellt. Dessa ändringar är giltiga, men kan vara annorlunda än om de görs via redigeringsprogram. Om du till exempel byter namn på en semantisk modellkolumn i Git och importerar den här ändringen till arbetsytan, nästa gång du checkar in ändringar i den semantiska modellen, registreras bim-filen som ändrad och den ändrade kolumnen skickas till baksidan av matrisen columns . Det beror på att AS-motorn som genererar bim-filerna skickar omdöpta kolumner till slutet av matrisen. Den här ändringen påverkar inte hur objektet fungerar.
  • Checka in en fil som använder CRLF-radbrytningar . Tjänsten använder radbrytningar för LF (radmatning). Om du hade objektfiler på Git-lagringsplatsen med CRLF-radbrytningar ändras filerna till LF när du checkar in från tjänsten. Om du till exempel öppnar en rapport på skrivbordet sparar du .pbip-projektet och laddar upp det till Git med hjälp av CRLF.
• Om du uppdaterar en semantisk modell med hjälp av API:et för förbättrad uppdatering orsakas en Git-diff efter varje uppdatering.

Relaterat innehåll

• Förstå Git-integreringsprocessen
• Hantera Git-grenar
• Metodtips för Git-integrering