Git-verziókövetés jegyzetfüzetekhez (örökölt)

Fontos

Az örökölt notebook Git-integráció támogatását 2024. január 31-én megszüntették. A Databricks azt javasolja, hogy a Databricks Git-mappákkal szinkronizálja a Databricksben végzett munkát egy távoli Git-adattárral.

Ez a cikk bemutatja, hogyan állíthatja be a Git-verziókövetést a jegyzetfüzetekhez (régi funkció). A Databricks CLI-vel vagy a Workspace API-val jegyzetfüzeteket importálhat és exportálhat, valamint Git-műveleteket hajthat végre a helyi fejlesztési környezetben.

A Git verziószámozásának engedélyezése és letiltása

A verziókövetés alapértelmezés szerint engedélyezve van. A beállítás váltása:

  1. Nyissa meg a Beállítások>munkaterület beállításait.
  2. A Speciális szakaszban kapcsolja ki a Notebook Git verziókezelés kapcsolót.

Verziókövetés konfigurálása

A verziókövetés konfigurálásához hozzon létre hozzáférési hitelesítő adatokat a Git-szolgáltatóban, majd adja hozzá ezeket a hitelesítő adatokat az Azure Databrickshez.

Jegyzetfüzet-verziók használata

A jegyzetfüzetek verzióit az előzmények panelen használhatja. Nyissa meg az előzménypanelt a jobb oldali oldalsávra kattintva verzióelőzmények ikon .

Korábbi verziók

Megjegyzés

Nem módosíthatja a jegyzetfüzetet, amíg az előzménypanel meg van nyitva.

  1. Kattintson verzióelőzmények ikon a jobb oldali oldalsávra. A Git állapotsoron megjelenik a Git: Nincs csatolva.

    Git állapotsor

  2. Kattintson a Git: Nincs csatolva elemre.

    Megjelenik a Git-beállítások párbeszédpanel. A jegyzetfüzet első megnyitásakor az állapot leválasztva lesz, mivel a jegyzetfüzet nem a GitHubon található.

    Git-beállítások – új jegyzetfüzet csatolása

  3. Az Állapot mezőben kattintson a Hivatkozás gombra.

  4. A Hivatkozás mezőbe illessze be a GitHub-adattár URL-címét.

  5. Kattintson a Ág legördülő listára, és válasszon ki egy ágat, vagy írja be az új ág nevét.

  6. A Git mappa Elérési útja mezőjében adja meg, hogy az adattárban hol tárolja a fájlt.

    A Python-jegyzetfüzetek a javasolt alapértelmezett fájlkiterjesztéssel .pyrendelkeznek. Ha használja .ipynb, a jegyzetfüzet iPython-jegyzetfüzet formátumban fog menteni. Ha a fájl már létezik a GitHubon, közvetlenül másolhatja és beillesztheti a fájl URL-címét.

  7. Kattintson a Mentés gombra a jegyzetfüzet csatolásának befejezéséhez. Ha ez a fájl korábban nem létezett, megjelenik egy üzenet a Fájl mentése a GitHub-tárházába lehetőséggel.

  8. Írjon be egy üzenetet, és kattintson a Mentés gombra.

Jegyzetfüzet mentése a GitHubra

Bár a jegyzetfüzeten végrehajtott módosítások automatikusan az Azure Databricks verzióelőzményeibe kerülnek, a módosítások nem maradnak automatikusan a GitHubon.

  1. Kattintson verzióelőzmények ikon a jobb oldali oldalsávra az előzmények panel megnyitásához.

    Előzmények panel – mentse most

  2. A Jegyzetfüzet GitHubra mentéséhez kattintson a Mentés gombra . Megjelenik a Jegyzet verziójának mentése párbeszédpanel.

  3. Ha szeretné, írjon be egy üzenetet a módosítás leírásához.

  4. Győződjön meg róla, hogy a(z) Véglegesítés a Gitben is lehetőség ki van jelölve.

    Verzió mentése

  5. Kattintson a Mentés gombra.

Jegyzetfüzet visszaállítása vagy frissítése a GitHubból származó verzióra

Miután összekapcsolt egy jegyzetfüzetet, az Azure Databricks minden alkalommal szinkronizálja az előzményeket a Gittel, amikor újra megnyitja az előzménypanelt. A Git-hez szinkronizált verziók véglegesítési kivonatokkal rendelkeznek a bejegyzés részeként.

  1. Kattintson verzióelőzmények ikon a jobb oldali oldalsávra az előzmények panel megnyitásához.

    Előzmények panelje

  2. Válasszon egy bejegyzést az előzmények panelen. Az Azure Databricks megjeleníti ezt a verziót.

  3. Kattintson A verzió visszaállításagombra.

  4. Kattintson a megerősítés gombra a verzió visszaállításának véglegesítéséhez.

  1. Kattintson verzióelőzmények ikon a jobb oldali oldalsávra az előzmények panel megnyitásához.

  2. A Git állapotsoron megjelenik a Git: Szinkronizálva állapot.

    Előzmények panel – aktuális kép mentése

  3. Kattintson a Git: Szinkronizálva elemre.

    Git-beállítások – a jegyzetfüzet kapcsolatának megszüntetése

  4. A Git beállításai párbeszédpanelen kattintson a Leválasztás gombra.

  5. Kattintson a Mentés gombra.

  6. Kattintson a Megerősítés gombra annak megerősítéséhez, hogy le szeretné-e választani a jegyzetfüzetet a verziókövetésről.

Használjon ágakat

Az adattár bármely ágán dolgozhat, és új ágakat hozhat létre az Azure Databricksben.

Ág létrehozása

  1. Kattintson verzióelőzmények ikon a jobb oldali oldalsávra az előzmények panel megnyitásához.

  2. Kattintson a Git állapotsorára a GitHub panel megnyitásához.

  3. Kattintson az Ág legördülő listára.

  4. Adjon meg egy ágnevet.

    Ág létrehozása

  5. Válassza az Ág létrehozása lehetőséget a legördülő lista alján. A szülőág látható. Mindig az aktuális kijelölt ágból ágazhat el.

Lekéréses kérelem létrehozása

  1. Kattintson verzióelőzmények ikon a jobb oldali oldalsávra az előzmények panel megnyitásához.

  2. Kattintson a Git állapotsorára a GitHub panel megnyitásához.

    Git-beállítások – lekéréses kérelem létrehozása

  3. Kattintson a PR létrehozása elemre. A GitHub megnyitja az ághoz tartozó pull request oldalt.

Ág újraalapozása

Az ágat az Azure Databricksben is újrabázisozhatja. Az Újrabázis hivatkozás megjeleníti, hogy az új véglegesítések elérhetők-e a szülőágban. Csak a szülőadattár alapértelmezett ága fölött történő újrabehozás támogatott.

Rebase

Például tegyük fel, hogy éppen a(z) databricks/reference-apps elemén dolgozik. Lemásolja a saját fiókjába (például brkyvz), és elkezd dolgozni egy my-branch nevű ágon. Ha új frissítés érkezik a databricks:master-ra, megjelenik a Rebase gomb, és lekérheti a módosításokat a brkyvz:my-branchágába.

A rebase kissé eltérően működik az Azure Databricksben. Tegyük fel, hogy a következő ágstruktúra adott:

Ágstruktúra újrabázisa előtt

Az újrabázis után az ágstruktúra a következőképpen néz ki:

Ágstruktúra újrabázisa után

Itt az a különbség, hogy a C5 és C6 commit-ek nem alkalmazhatók a C4-re. Ezek helyi módosításként jelennek meg a jegyzetfüzetben. Az egyesítési ütközések az alábbiak szerint jelennek meg:

Egyesítési ütközés

Ezután ismét véglegesítheti a GitHubra a módosításokat a Save Now gombbal.

Mi történik, ha valaki elágazik az ágamról, amit most adtam át?

Ha az ága (például branch-a) egy másik ág (branch-b) kiindulási alapjaként szolgált, és újraalapozza, nincs miért aggódnia! Ha egy felhasználó a branch-b elemet is újraalapozza, minden rendben fog működni. Ebben a helyzetben bevált gyakorlat, hogy minden jegyzetfüzethez külön ágat használjunk.

Ajánlott eljárások a kódértékelésekhez

Az Azure Databricks támogatja a Git-elágazást.

  • A jegyzetfüzeteket az adattár bármely ágához csatolhatja. Az Azure Databricks azt javasolja, hogy minden jegyzetfüzethez külön ágat használjon.
  • A fejlesztés során összekapcsolhatja a jegyzetfüzeteket egy adattár elágazásához vagy a fő adattár nem alapértelmezett ágához. A módosítások upstream integrálásához használhatja az Azure Databricks Git Preferences párbeszédpaneljén található PR létrehozása hivatkozást egy GitHub pull request létrehozásához. A Lekéréses kérelem létrehozása hivatkozás csak akkor jelenik meg, ha nem a szülőadattár alapértelmezett ágán dolgozik.

Hibaelhárítás

Ha a GitHub-előzmények szinkronizálásával kapcsolatos hibaüzenetet kap, ellenőrizze a következőket:

  • Jegyzetfüzetet csak inicializált Git-adattárhoz csatolhat, amely nem üres. Tesztelje az URL-címet egy webböngészőben.
  • A GitHub személyes hozzáférési tokennek aktívnak kell lennie.
  • Privát GitHub-adattár használatához az adattár olvasására vonatkozó engedéllyel kell rendelkeznie.
  • Ha egy jegyzetfüzet egy átnevezett GitHub-ághoz van csatolva, a módosítás nem jelenik meg automatikusan az Azure Databricksben. A notebookot manuálisan kell újracsatolnia az ághoz.

Migrálás a Databricks Git-mappákba

Az örökölt Git-verziókövetésből a Databricks Git-mappákba migrálni kívánt felhasználók az alábbi útmutatót használhatják:

  • Utolsó frissítés időpontja: