Git-versiebeheer voor notebooks (verouderd)

Belangrijk

Ondersteuning voor Git-integratie van verouderde notebooks is verwijderd op 31 januari 2024. Databricks raadt u aan om Databricks Git-mappen te gebruiken om uw werk in Databricks te synchroniseren met een externe Git-opslagplaats.

In dit artikel wordt beschreven hoe u Git-versiebeheer instelt voor notebooks (verouderde functie). U kunt ook de Databricks CLI of Werkruimte-API gebruiken om notebooks te importeren en exporteren en Git-bewerkingen uit te voeren in uw lokale ontwikkelomgeving.

Git-versiebeheer in- en uitschakelen

Standaard is versiebeheer ingeschakeld. U kunt deze instelling als volgt in- of uitschakelen:

  1. Ga naar Instellingen>Werkruimte-instellingen.
  2. Schakel in de sectie Geavanceerd de schakeloptie Git-versiebeheer voor notebook uit.

Versiebeheer configureren

Als u versiebeheer wilt configureren, maakt u toegangsreferenties in uw Git-provider en voegt u deze referenties toe aan Azure Databricks.

Werken met notebookversies

U werkt met notebookversies in het geschiedenispaneel. Open het geschiedenisvenster door in de rechterzijbalk te pictogram versiegeschiedenis klikken.

Versiegeschiedenis

Notitie

U kunt een notitieblok niet wijzigen terwijl het geschiedenisvenster is geopend.

  1. Klik pictogram versiegeschiedenis in de rechterzijbalk. Op de Git-statusbalk wordt Git: Niet gekoppeld weergegeven.

    Git-statusbalk

  2. Klik op Git: niet gekoppeld.

    Het dialoogvenster Git-voorkeuren wordt weergegeven. De eerste keer dat u uw notitieblok opent, is de status Ontkoppelen, omdat het notitieblok zich niet in GitHub bevindt.

    Git-voorkeuren - nieuw notitieblok koppelen

  3. Klik in het veld Status op Koppeling.

  4. Plak in het veld Koppeling de URL van de GitHub-opslagplaats.

  5. Klik op de vervolgkeuzelijst Branch en selecteer een vertakking of typ de naam van een nieuwe vertakking.

  6. Geef in het veld Pad in git-map op waar in de opslagplaats het bestand moet worden opgeslagen.

    Python-notebooks hebben de voorgestelde standaardbestandsextensie .py. Als u .ipynb gebruikt, wordt uw notebook opgeslagen in de indeling van een iPython-notebook. Als het bestand al bestaat op GitHub, kunt u de URL van het bestand rechtstreeks kopiëren en plakken.

  7. Klik op Opslaan om het koppelen van uw notitieblok te voltooien. Als dit bestand nog niet eerder bestond, wordt er een prompt weergegeven met de optie Dit bestand opslaan in uw GitHub-opslagplaats .

  8. Typ een bericht en klik op Opslaan.

Een notitieblok opslaan in GitHub

Hoewel de wijzigingen die u in uw notebook aanbrengt, automatisch worden opgeslagen in de versiegeschiedenis van Azure Databricks, blijven wijzigingen niet automatisch behouden in GitHub.

  1. Klik pictogram versiegeschiedenis in de rechterzijbalk om het geschiedenisvenster te openen.

    Geschiedenisvenster - nu opslaan

  2. Klik op Nu opslaan om uw notitieblok op te slaan in GitHub. Het dialoogvenster 'Notebookversie opslaan' verschijnt.

  3. Voer desgewenst een bericht in om uw wijziging te beschrijven.

  4. Zorg ervoor dat ook doorvoeren naar Git is geselecteerd.

    Versie opslaan

  5. Klik op Opslaan.

Een notebook herstellen of bijwerken naar een versie vanuit GitHub

Zodra u een notebook hebt gekoppeld, synchroniseert Azure Databricks uw geschiedenis met Git telkens wanneer u het geschiedenisvenster opnieuw opent. Versies die met Git worden gesynchroniseerd, hebben commit-hashes als onderdeel van de invoer.

  1. Klik pictogram versiegeschiedenis in de rechterzijbalk om het geschiedenisvenster te openen.

    Geschiedenispaneel

  2. Kies een vermelding in het geschiedenisvenster. Azure Databricks geeft die versie weer.

  3. Klik op Herstel deze versie.

  4. Klik op Bevestig om te bevestigen dat u die versie wilt herstellen.

  1. Klik pictogram versiegeschiedenis in de rechterzijbalk om het geschiedenisvenster te openen.

  2. Op de Git-statusbalk wordt Git: Gesynchroniseerd weergegeven.

    Geschiedenisvenster - afbeelding nu opslaan

  3. Klik op Git: gesynchroniseerd.

    Git-voorkeuren - notebook ontkoppelen

  4. Klik in het dialoogvenster Git-voorkeuren op Ontkoppelen.

  5. Klik op Opslaan.

  6. Klik op Bevestigen om te bevestigen dat u het notitieblok wilt ontkoppelen van versiebeheer.

Branches gebruiken

U kunt aan elke vertakking van uw opslagplaats werken en nieuwe vertakkingen maken in Azure Databricks.

Een branch aanmaken

  1. Klik pictogram versiegeschiedenis in de rechterzijbalk om het geschiedenisvenster te openen.

  2. Klik op de Git-statusbalk om het GitHub-deelvenster te openen.

  3. Klik op de keuzelijst Branch.

  4. Voer een branchnaam in.

    Vertakking maken

  5. Selecteer de optie Branch maken onderaan de vervolgkeuzelijst. De bovenliggende vertakking wordt aangegeven. U maakt altijd een branch aan vanaf de momenteel geselecteerde branch.

Een pull-aanvraag maken

  1. Klik pictogram versiegeschiedenis in de rechterzijbalk om het geschiedenisvenster te openen.

  2. Klik op de Git-statusbalk om het GitHub-deelvenster te openen.

    Git-voorkeuren - pull-aanvraag maken

  3. Klik op PR maken. GitHub opent de pull request-pagina voor de branch.

Een vertakking opnieuwbaseen

U kunt uw vertakking ook opnieuw baseeren in Azure Databricks. De Rebase-link wordt weergegeven wanneer er nieuwe commits beschikbaar zijn in de bovenliggende branch. Alleen rebasen op de standaardbranch van de bovenliggende repository wordt ondersteund.

Rebase

Stel dat u aan databricks/reference-appswerkt. Je forked het naar je eigen account (bijvoorbeeld brkyvz) en gaat aan de slag op een branch met de naam my-branch. Als er een nieuwe update naar databricks:masterwordt gepusht, wordt de Rebase knop weergegeven en kunt u de wijzigingen in uw branch brkyvz:my-branchophalen.

Rebasing werkt iets anders in Azure Databricks. Ga ervan uit dat de volgende vertakkingsstructuur is:

Voordat de vertakkingsstructuur opnieuw wordt gebaseerd

Na een nieuwe basis ziet de vertakkingsstructuur er als volgt uit:

Na de herbase-vertakkingsstructuur

Wat hier anders is, is dat Commits C5 en C6 niet van toepassing zijn bovenop C4. Ze worden weergegeven als lokale wijzigingen in uw notitieblok. Samenvoegingsconflicten worden als volgt weergegeven:

Mergeconflict

U kunt vervolgens opnieuw een commit uitvoeren naar GitHub met de knop Nu opslaan.

Wat gebeurt er als iemand vertakt van mijn vertakking die ik zojuist heb herbased?

Als uw vertakking (bijvoorbeeld branch-a) de basis was voor een andere vertakking (branch-b) en u zich opnieuw baseert, hoeft u zich geen zorgen te maken. Zodra een gebruiker ook branch-b rebase't, komt alles goed. De beste werkwijze in deze situatie is om aparte branches voor verschillende notebooks te gebruiken.

Aanbevolen werkwijzen voor codereviews

Azure Databricks biedt ondersteuning voor Git-vertakkingen.

  • U kunt een notebook koppelen aan elke vertakking in een opslagplaats. Azure Databricks raadt aan om voor elk notebook een afzonderlijke vertakking te gebruiken.
  • Tijdens de ontwikkeling kunt u een notebook koppelen aan een fork van een repository of aan een niet-standaardbranch in de hoofdrepository. Als u uw wijzigingen wilt integreren in de upstream-repository, kunt u in Azure Databricks de koppeling PR maken in het dialoogvenster Git-voorkeuren gebruiken om een GitHub-pullrequest te maken. De koppeling Pull-aanvraag maken wordt alleen weergegeven als u niet werkt aan de standaardvertakking van de bovenliggende opslagplaats.

Probleemoplossing

Als u fouten ontvangt met betrekking tot de synchronisatie van de GitHub-geschiedenis, controleert u het volgende:

  • U kunt een notebook alleen koppelen aan een geïnitialiseerde Git-opslagplaats die niet leeg is. Test de URL in een webbrowser.
  • Het persoonlijk toegangstoken van GitHub moet actief zijn.
  • Als u een privé GitHub opslagplaats wilt gebruiken, moet u zijn gemachtigd om de opslagplaats te lezen.
  • Als een notebook is gekoppeld aan een GitHub-branch waarvan de naam wordt gewijzigd, wordt die wijziging niet automatisch weergegeven in Azure Databricks. U moet het notebook handmatig opnieuw koppelen aan de vertakking.

Migreren naar Git-mappen van Databricks

Gebruikers die vanuit het verouderde Git-versiebeheer naar Databricks Git-mappen moeten migreren, kunnen de volgende handleiding gebruiken:

  • Last updated on