Hantera en arbetsyta med Git (förhandsversion)

  • Artikel

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

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

Viktigt!

Den här funktionen är i förhandsversion.

Förutsättningar

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

Krav för Azure DevOps

  • Ett aktivt Azure-konto som har registrerats för samma användare som använder arbetsytan Infrastruktur. Skapa ett kostnadsfritt konto.
  • Åtkomst till en befintlig lagringsplats.

Krav för infrastrukturresurser

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

Dessutom måste organisationens administratör aktivera användare kan skapa infrastrukturobjekt klientväxel från administratörsportalen.

Skärmbild av Fabric-växeln aktiverad.

Anslut en arbetsyta till en Azure-lagringsplats

Endast en arbetsyteadministratör kan ansluta en arbetsyta till en Azure-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-lagringsplats:

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

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

    Skärmbild av arbetsytan med ikonen för arbetsyteinställningar som visas överst.

    Kommentar

    Om du inte ser ikonen Inställningar för arbetsyta väljer du ellipsen (tre punkter) och sedan arbetsyteinställningarna. Skärmbild av arbetsytan med länken för arbetsyteinställningar som visas från ellipsen.

  3. Välj Git-integrering. Du loggas automatiskt in på Azure Repos-kontot som registrerats för Microsoft Entra-användaren som är inloggad i Fabric.

    Skärmbild av fönstret för arbetsyteinställningar med Git-integrering valt.

  4. I den nedrullningsbara menyn anger du följande information om den gren som du vill ansluta till:

    Kommentar

    Du kan bara ansluta en arbetsyta till en gren och en mapp i taget.

    • Organisation
    • Projekt
    • Git-lagringsplats
    • Gren (Välj en befintlig gren med hjälp av den nedrullningsbara menyn eller välj + Ny gren för att skapa en ny gren. Du kan bara ansluta till en gren i taget.)
    • Mapp (Välj en befintlig mapp i grenen eller ange ett namn för att skapa en ny mapp. Om du inte väljer en mapp skapas innehållet i rotmappen. Du kan bara ansluta till en mapp i taget.)

  5. 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 Anslut och synkronisering.

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.

Skärmbild av källkontrollikonen och annan Git-information.

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.

Följ dessa steg om du vill checka in ändringarna i Git-grenen:

  1. Gå till arbetsytan.

  2. Välj ikonen Källkontroll. Den här ikonen visar antalet icke-bakåtkompatibla ändringar. Skärmbild av källkontrollikonen med nummer 2 som anger att det finns två ändringar att checka in.

  3. Välj fliken Ändringar i fönstret Källkontroll . En lista visas med alla objekt som du har ändrat och en ikon som anger om objektet är nytt, ändrat, står i konflikt med eller tagits bort.

  4. Välj de objekt som du vill checka in. Markera den översta kryssrutan om du vill markera alla objekt.

  5. Lägg till en kommentar i rutan. Om du inte lägger till en kommentar läggs ett standardmeddelande till automatiskt.

  6. Välj Checka in.

    Skärmbild av källkontrollfönstret med två ändringar valda för incheckning.

När ändringarna har checkats in tas de objekt som har checkats in bort från listan och arbetsytan pekar på den nya incheckningen som den synkroniseras till.

Skärmbild av källkontrollfönstret som anger att det inte finns några ändringar att checka in.

När incheckningen har slutförts ändras statusen för de markerade objekten från Ej bekräftad till Synkroniserad.

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 fönstret Källkontroll 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 fliken Uppdateringar i fönstret Källkontroll. En lista visas med alla objekt som har ändrats i grenen sedan den senaste uppdateringen.
  4. Välj Uppdatera alla.

Skärmbild av källkontrollfönstret med uppdateringsfliken öppen och knappen Uppdatera alla har valts.

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

Skärmbild av källkontrollfönstret som anger att du har uppdaterat arbetsytan.

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 Azure-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

    Skärmbild av skärmen för arbetsyteinställningar med alternativet Koppla från arbetsyta.

  4. Bekräfta genom att välja Koppla från igen.

    Skärmbild av skärmen för arbetsyteinställningar som frågar om du är säker på att du vill koppla från.

Behörigheter

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

Beaktanden och begränsningar

  • Under incheckningen till Git-processen tar Fabric-tjänsten bort alla 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 har problem med dessa åtgärder ska du se till att du förstår begränsningarna i Git-integreringsfunktionen.

Relaterat innehåll