Dela via

Git-versionskontroll för notebook-filer (äldre)

  • Artikel

Viktigt!

Git-integreringsstöd för äldre notebook-filer togs bort den 31 januari 2024. Databricks rekommenderar att du använder Databricks Git-mappar för att sync ditt arbete i Databricks med en fjärransluten Git-lagringsplats.

Den här artikeln beskriver hur du set upp Git-versionskontroll för notebook-filer (äldre funktion). Du kan också använda Databricks CLI- eller arbetsyte-API:et för att importera och exportera notebook-filer och utföra Git-åtgärder i din lokala utvecklingsmiljö.

Aktivera och inaktivera Git-versionshantering

Versionskontroll är aktiverat som standard. Så här växlar du den här inställningen:

  1. Gå till Inställningar>Arbetsyteinställningar.
  2. I avsnittet Avancerat avmarkerar du växlingsknappen Git-versionshantering för notebook-filer.

Konfigurera versionskontroll

Om du vill konfigurera versionskontroll skapar du åtkomst credentials i Git-providern och lägger sedan till dessa credentials i Azure Databricks.

Arbeta med notebook-versioner

Du arbetar med notebook-versioner i historikpanelen. Öppna historikpanelen genom att ikon för versionshistorik klicka i det högra sidofältet.

Versionshistorik

Kommentar

Du kan inte ändra en anteckningsbok när historikpanelen är öppen.

  1. Klicka ikon för versionshistorik i det högra sidofältet. Git-statusfältet visar Git: Inte länkad.

    Git-statusfält

  2. Klicka på Git: Inte länkad.

    Dialogrutan Git-inställningar visas. Första gången du öppnar anteckningsboken är statusen Avlänk, eftersom notebook-filen inte finns i GitHub.

    Git-inställningar – länka ny notebook-fil

  3. I fältet Status klickar du på Länk.

  4. I fältet Länk klistrar du in URL:en för GitHub-lagringsplatsen.

  5. Klicka på listrutan Branch och select en gren eller skriv namnet på en ny gren.

  6. I fältet Sökväg i Git-mapp anger du where på lagringsplatsen för att lagra filen.

    Python-notebook-filer har det föreslagna standardfiltillägget .py. Om du använder .ipynbsparas notebook-filen i iPython Notebook-format. Om filen redan finns på GitHub kan du kopiera och klistra in filens URL direkt.

  7. Klicka på Spara för att slutföra länkningen av anteckningsboken. Om den här filen inte fanns tidigare visas en uppmaning med alternativet Spara den här filen på din GitHub-lagringsplats .

  8. Skriv ett meddelande och klicka på Spara.

Spara en notebook-fil på GitHub

Även om de ändringar du gör i notebook-filen sparas automatiskt i Versionshistoriken för Azure Databricks sparas inte ändringarna automatiskt på GitHub.

  1. Klicka ikon för versionshistorik i det högra sidofältet för att öppna historikpanelen.

    Historikpanel – spara nu

  2. Klicka på Spara nu för att spara anteckningsboken på GitHub. Dialogrutan Spara notebook-version visas.

  3. Du kan också ange ett meddelande för att beskriva ändringen.

  4. Kontrollera att Även incheckning till Git är markerat.

    Spara version

  5. Klicka på Spara.

Återställ eller update en notebook-fil till en version från GitHub

När du har länkat en notebook-fil synkroniserar Azure Databricks din historik med Git varje gång du öppnar historikpanelen igen. Versioner med sync till Git har incheckningshashvärden som en del av inlägget.

  1. Klicka ikon för versionshistorik i det högra sidofältet för att öppna historikpanelen.

    Panel för historik

  2. Välj en post i historikpanelen. Azure Databricks visar den versionen.

  3. Klicka på Restore den här versionen.

  4. Klicka på Bekräfta för att bekräfta att du vill restore den versionen.

  1. Klicka ikon för versionshistorik i det högra sidofältet för att öppna historikpanelen.

  2. Git-statusfältet visar Git: Synkroniserad.

    Historikpanel – spara nu bild

  3. Klicka på Git: Synkroniserad.

    Git-inställningar – ta bort länk till notebook-fil

  4. I dialogrutan Git-inställningar klickar du på Ta bort länk.

  5. Klicka på Spara.

  6. Klicka på Bekräfta för att bekräfta att du vill ta bort länken till anteckningsboken från versionskontroll.

Använda grenar

Du kan arbeta på valfri gren av lagringsplatsen och skapa nya grenar i Azure Databricks.

Skapa en gren

  1. Klicka ikon för versionshistorik i det högra sidofältet för att öppna historikpanelen.

  2. Klicka på Git-statusfältet för att öppna GitHub-panelen.

  3. Klicka på listrutan Gren .

  4. Ange ett grennamn.

    Skapa förgrening

  5. Select alternativet Skapa gren längst ned i listrutan. Den överordnade grenen anges. Du förgrenar alltid från den aktuella valda grenen.

Skapa en pull-begäran

  1. Klicka ikon för versionshistorik i det högra sidofältet för att öppna historikpanelen.

  2. Klicka på Git-statusfältet för att öppna GitHub-panelen.

    Git-inställningar – skapa pull-begäran

  3. Klicka på Skapa PR. GitHub öppnas på en sida för pull-begäran för grenen.

Ändra bas på en gren

Du kan också ombasera din gren i Azure Databricks. Länken Rebase visar om nya incheckningar är tillgängliga i den överordnade grenen. Endast ombasering ovanpå standardgrenen för den överordnade lagringsplatsen stöds.

Rebase

Anta till exempel att du arbetar med databricks/reference-apps. Du förgrenar det till ditt eget konto (till exempel brkyvz) och börjar arbeta med en gren med namnet my-branch. Om en ny update skickas till databricks:mastervisas knappen Rebase och du kan hämta ändringarna till din gren brkyvz:my-branch.

Ombasering fungerar lite annorlunda i Azure Databricks. Anta följande grenstruktur:

Före ombasering av grenstruktur

Efter en ombasering ser grenstrukturen ut så här:

Efter ombasering av grenstruktur

Det som skiljer sig här är att Commits C5 och C6 inte gäller ovanpå C4. De visas som lokala ändringar i anteckningsboken. Sammanslagningskonflikter visas på följande sätt:

Sammanslagningskonflikt

Du kan sedan checka in på GitHub igen med knappen Spara nu .

Vad händer om någon har förgrenat sig från min gren som jag just har rebaserat?

Om din gren (till exempel branch-a) var basen för en annan gren (branch-b) och du baserar om behöver du inte oroa dig! När en användare också förbaseras branch-bkommer allt att fungera. Det bästa sättet i den här situationen är att använda separata grenar för separata notebook-filer.

Metodtips för kodgranskningar

Azure Databricks stöder Git-förgrening.

  • Du kan länka en notebook-fil till valfri gren på en lagringsplats. Azure Databricks rekommenderar att du använder en separat gren för varje notebook-fil.
  • Under utvecklingen kan du länka en notebook-fil till en förgrening av en lagringsplats eller till en icke-standardgren på huvudlagringsplatsen. Om du vill integrera dina ändringar uppströms kan du använda länken Skapa PR i dialogrutan Git-inställningar i Azure Databricks för att skapa en GitHub-pull-begäran. Länken Skapa PR visas endast om du inte arbetar med standardgrenen för den överordnade lagringsplatsen.

Felsökning

Om du får fel som gäller synkronisering av GitHub-historiken kontrollerar du följande:

  • Du kan bara länka en notebook-fil till en initierad Git-lagringsplats som inte är tom. Testa webbadressen i en webbläsare.
  • Den personliga åtkomsttoken för GitHub måste vara aktiv.
  • Om du vill använda en privat GitHub-lagringsplats måste du ha behörighet att läsa lagringsplatsen.
  • Om en notebook-fil är länkad till en GitHub-gren som har bytt namn återspeglas inte ändringen automatiskt i Azure Databricks. Du måste länka om notebook-filen till grenen manuellt.

Migrera till Databricks Git-mappar

Användare som behöver migrera till Databricks Git-mappar från den äldre Git-versionskontrollen kan använda följande guide: