Správa verzí pomocí Gitu pro poznámkové bloky (zastaralé)

Důležité

Podpora integrace Git pro starší verzi poznámkového bloku byla odstraněna 31. ledna 2024. Databricks doporučuje používat složky Git Databricks k synchronizaci práce v Databricks se vzdáleným úložištěm Git.

Tento článek popisuje, jak nastavit správu verzí Gitu pro poznámkové bloky (starší verze funkce). Můžete také použít Databricks CLI nebo Workspace API k importu a exportu poznámkových bloků a k provádění operací Git v místním vývojovém prostředí.

Povolení a zákaz správy verzí v Gitu

Ve výchozím nastavení je povolená správa verzí. Přepnutí tohoto nastavení:

  1. Přejděte na Nastavení>pracovního prostoru.
  2. V části Pokročilé vypněte přepínač Správa verzí Git pro poznámkové bloky.

Konfigurace správy verzí

Pokud chcete nakonfigurovat správu verzí, vytvořte v poskytovateli Gitu přihlašovací údaje pro přístup a pak tyto přihlašovací údaje přidejte do Azure Databricks.

Práce s verzemi poznámkového bloku

Na panelu historie pracujete s verzemi poznámkového bloku. Kliknutím na pravý boční panel otevřete Ikona historie verzí panel historie.

Historie verzí

Poznámka:

Poznámkový sešit nelze upravit, pokud je panel historie otevřený.

  1. Klikněte na ikonu historie verzí v pravém postranním panelu. Na stavovém řádku Gitu se zobrazí Git: Není propojený.

    Stavový řádek Gitu

  2. Klikněte na Git: Není propojený.

    Zobrazí se dialogové okno Předvolby Gitu. Když poprvé otevřete svůj poznámkový blok, stav je Unlink, protože poznámkový blok není na GitHubu.

    Předvolby Gitu – odkaz na nový poznámkový blok

  3. V poli Stav klikněte na Link.

  4. Do pole Odkaz vložte adresu URL úložiště GitHub.

  5. Klikněte na rozevírací seznam Větev a vyberte větev nebo zadejte název nové větve.

  6. V poli Cesta ve složce Git určete, kam se má soubor uložit v úložišti.

    Poznámkové bloky Pythonu mají doporučenou výchozí příponu souboru .py. Pokud použijete .ipynb, poznámkový blok se uloží ve formátu poznámkového bloku iPython. Pokud soubor už na GitHubu existuje, můžete přímo zkopírovat a vložit adresu URL souboru.

  7. Kliknutím na Uložit dokončíte propojení poznámkového bloku. Pokud tento soubor ještě neexistuje, zobrazí se výzva s možností Uložit tento soubor do úložiště GitHub.

  8. Zadejte zprávu a klikněte na Uložit.

Uložte poznámkový blok na GitHub

Zatímco změny provedené v poznámkovém bloku se automaticky ukládají do historie verzí Azure Databricks, změny se automaticky neuchovávají na GitHubu.

  1. Kliknutím Ikona historie verzí na pravý boční panel otevřete panel historie.

    Panel Historie – uložit

  2. Kliknutím na Uložit teď poznámkový blok uložte na GitHub. Zobrazí se dialogové okno Uložit verzi poznámkového bloku.

  3. Volitelně můžete zadat zprávu s popisem změny.

  4. Ujistěte se, že je vybrána možnost Také potvrdit do Git.

    Uložit verzi

  5. Klikněte na Uložit.

Vrácení nebo aktualizace poznámkového bloku na verzi z GitHubu

Po propojení poznámkového bloku azure Databricks synchronizuje historii s Gitem při každém opětovném otevření panelu historie. Verze, které se synchronizují s Gitem, mají v rámci položky potvrzení hodnot hash.

  1. Kliknutím Ikona historie verzí na pravý boční panel otevřete panel historie.

    Panel Historie

  2. Zvolte položku na panelu historie. Azure Databricks zobrazí danou verzi.

  3. Klikněte na Obnovit tuto verzi.

  4. Kliknutím na Potvrdit potvrďte , že chcete obnovit tuto verzi.

  1. Kliknutím Ikona historie verzí na pravý boční panel otevřete panel historie.

  2. Na stavovém řádku Gitu se zobrazí Git: Synchronizovaný.

    Panel Historie – uložit obrázek

  3. Klikněte na Git: Synchronizované.

    Předvolby Gitu – zrušení propojení poznámkového bloku

  4. V dialogovém okně Předvolby Gitu klikněte na Zrušit propojení.

  5. Klikněte na Uložit.

  6. Kliknutím na Tlačítko Potvrdit potvrďte , že chcete zrušit propojení poznámkového bloku se správou verzí.

Použití větví

Můžete pracovat na libovolné větvi úložiště a vytvářet nové větve v Azure Databricks.

Vytvoření větve

  1. Kliknutím Ikona historie verzí na pravý boční panel otevřete panel historie.

  2. Kliknutím na stavový řádek Gitu otevřete panel GitHubu.

  3. Klikněte na rozevírací nabídku Branch.

  4. Zadejte název větve.

    Vytvářet větve

  5. V dolní části rozevíracího seznamu vyberte možnost Vytvořit větev. Je uvedena nadřazená větev. Novou větev vždy vytvoříte z aktuálně vybrané větve.

Vytvořit požadavek na sloučení

  1. Kliknutím Ikona historie verzí na pravý boční panel otevřete panel historie.

  2. Kliknutím na stavový řádek Gitu otevřete panel GitHubu.

    Předvolby Gitu – vytvoření žádosti o přijetí změn

  3. Klikněte na Vytvořit PR. GitHub otevře stránku žádosti o sloučení pro tuto větev.

Změna základu větve

V Azure Databricks můžete také přebázovat svou větev. Odkaz Rebase se zobrazí, pokud jsou v nadřazené větvi k dispozici nové commity. Podporován je pouze rebase na výchozí větev nadřazeného úložiště.

Rebase

Předpokládejme například, že pracujete na databricks/reference-apps. Vytvoříte si ve svém účtu fork (například brkyvz) a začnete pracovat na větvi s názvem my-branch. Pokud se do databricks:master nahraje nová aktualizace, zobrazí se tlačítko Rebase a budete moct stáhnout změny do své větve brkyvz:my-branch.

Přebazování funguje v Azure Databricks trochu jinak. Předpokládejme následující strukturu větve:

Před změnou struktury větve

Po obnovení struktury větve vypadá takto:

Struktura větve po opětovném vytvoření základu

Tady je rozdíl v tom, že commity C5 a C6 se neaplikují nad C4. V poznámkovém bloku se zobrazí jako místní změny. Konflikty při slučování se zobrazují takto:

Konflikt při slučování

Pak se můžete znovu potvrdit na GitHub pomocí tlačítka Uložit nyní .

Co se stane, když někdo vytvořil větev z mé větve, kterou jsem právě rebasoval?

Pokud byla vaše větev (například branch-a) výchozí větví pro jinou větev (branch-b) a pak ji přebasujete, nemusíte se bát! Jakmile uživatel také provede rebase branch-b, vše bude fungovat. Doporučeným postupem v této situaci je používat samostatné větve pro samostatné notebooky.

Osvědčené postupy pro revize kódu

Azure Databricks podporuje větvení Gitu.

  • Poznámkový blok můžete propojit s libovolnou větví v úložišti. Azure Databricks doporučuje pro každý poznámkový blok použít samostatnou větev.
  • Během vývoje můžete notebook propojit s forkem úložiště nebo s jinou než výchozí větví v hlavním úložišti. Pokud chcete své změny začlenit do upstreamu, můžete v Azure Databricks použít odkaz Vytvořit PR v dialogovém okně Předvolby Gitu k vytvoření pull requestu na GitHubu. Odkaz pro vytvoření PR se zobrazí jen tehdy, když nepracujete na výchozí větvi nadřazeného úložiště.

Řešení problému

Pokud se vám zobrazí chyby související se synchronizací historie GitHubu, ověřte následující:

  • Poznámkový blok můžete propojit pouze s inicializovaným úložištěm Git, které není prázdné. Otestujte adresu URL ve webovém prohlížeči.
  • Osobní přístupový token GitHubu musí být aktivní.
  • Pokud chcete použít privátní úložiště GitHubu, musíte k němu mít oprávnění ke čtení.
  • Pokud je poznámkový blok propojený s přejmenovanou větví GitHubu, změna se v Azure Databricks neprojeví automaticky. Notebook musíte znovu ručně propojit s větví.

Migrujte do složek Git v Databricks

Uživatelé, kteří potřebují migrovat do složek Git Databricks ze starší verze správy verzí Gitu, můžou použít následující příručku:

  • Poslední aktualizace v