Hibakeresési jegyzetfüzetek

Ez a lap bemutatja, hogyan használhatja a beépített interaktív hibakeresőt a Databricks-jegyzetfüzetben. A hibakereső csak Pythonhoz érhető el.

Az interaktív hibakereső töréspontokat, részletes végrehajtást, változóvizsgálatot és további eszközöket biztosít a jegyzetfüzetek kódjának hatékonyabb fejlesztéséhez.

Követelmények

A hibakereső eléréséhez a jegyzetfüzetnek az alábbi számítási erőforrások egyikéhez kell csatlakoznia:

A hibakereső engedélyezése

A hibakereső engedélyezéséhez kövesse az alábbi lépéseket:

  1. Kattintson a felhasználónevére a munkaterület jobb felső sarkában, és válassza a Beállítások lehetőséget a legördülő listából.
  2. A Beállítások oldalsávon válassza a Fejlesztőlehetőséget.
  3. A Editor beállításai szakaszban kapcsolja be Python Jegyzetfüzet interaktív hibakereső.

Hibakeresés indítása

A hibakereső elindításához kövesse az alábbi lépéseket:

  1. Egy vagy több töréspont hozzáadásához kattintson egy cella margójára. Töréspont eltávolításához kattintson rá újra.

    töréspontok videoképének létrehozása és eltávolítása

  2. Indítsa el a hibakeresési munkamenetet az alábbi lehetőségek egyikével:

    • Kattintson a Futtatás Debug cell > elemre.
    • Használja az Option + Shift +D billentyűparancsot.
    • A cellafuttatási menüben válassza ki a Hibakeresés cellát.

    cellaelem hibakeresése a cellafuttatási menüben

A hibakeresési munkamenet automatikusan elindul, és a kijelölt cellát futtatja.

A hibakeresőt akkor is elindíthatja, ha egy cella hibát vált ki. A cellakimenet alján kattintson a gombra Hibakeresés gomb.

Ha egy hibakeresési munkamenet aktív, a hibakeresési eszköztár Hibakeresési eszköztár a cella tetején jelenik meg.

Hibakeresési műveletek

jegyzetekkel ellátott hibakereső eszköztár

Hibakeresési munkamenetben a következőket teheti:

  • Töréspontok beállítása vagy eltávolítása.
  • A változók értékeinek megtekintése törésponton.
  • Lépjen végig a kódon.
  • Belépés vagy kilépés egy függvényből.
  • Keresse meg azt a vonalat, amelynél a hibakereső le van állítva.

Amikor a kód eléri a töréspontot, a sor futtatása előtt leáll, nem utána.

A hibakereső eszköztár gombjaival lépegethet a kódon. A kód végiglépésekor az aktuális sor ki van emelve a cellában. A változóértékeket a jobb oldali oldalsáv változókezelő paneljén tekintheti meg.

Ha végiglép egy függvényen, a helyi függvényváltozók megjelennek a változó panelen, megjelölve [local].

Lépjen be a munkaterület fájljaiba

Jegyzetfüzetek és fájlok lapjainak engedélyezésekor töréspontokat állíthat be, és beléphet más munkaterületi fájlokban definiált függvényekbe. Ha be szeretne lépni egy függvénybe, kattintson a belépés ikonjára lefelé mutató nyíl és pont ikonnal. Ha a függvény egy másik munkaterületfájlban van definiálva, a hibakereső egy új lapon fogja megnyitni a fájlt.

példa lépésként

Feljegyzés

  • A hibakereső csak a munkaterület fájljaiban definiált függvényekbe léphet be. A Python könyvtárakba vagy más jegyzetfüzetekbe való belépés még nem támogatott.
  • Ha a külső fájlokat az importálásuk után szerkessze, előfordulhat, hogy a jegyzetfüzet-munkamenet továbbra is a modul régi verzióját használja. Annak érdekében, hogy az importált modulok szerkesztései a hibakeresés során érvénybe lépjenek, használja a autoreload Python modulokat a Databricks Runtime 18.0-s vagy 4-es verziójú kiszolgáló nélküli számítási környezetében.

Hibakeresési konzol

Hibakeresési munkamenet indításakor a hibakeresési konzol automatikusan megjelenik az alsó panelen. Ez a konzol lehetővé teszi, hogy Python kódot hajtson végre a változók vizsgálatához vagy módosításához, amikor szünetet tartunk egy töréspontnál. A főjegyzetfüzetben végrehajtott kód nem fut hibakeresési munkamenet közben. A kód konzolon való futtatásához nyomja le az Enter billentyűt. Többsoros kifejezések esetén a Shift + Enter billentyűkombinációval válthat egy új sorra.

debug_console

Feljegyzés

  • A hibakeresési konzolt gyors kiértékelésekhez tervezték, és időtúllépés történik, ha a kód végrehajtása meghaladja a 15 másodpercet.
  • A display hibakeresési konzol nem támogatja a parancsot. A DataFrame-ből származó mintaadatok megtekintéséhez használja df.show() a PySpark DataFrames vagy df.head() a Pandas DataFrames használatát.

Változóböngésző

A változók értékeinek megtekintéséhez használhatja a változókezelő panelt, a jobb oldalon a változók ikonját. Az Ellenőrzés gombra kattintva automatikusan végrehajtja a kódot a hibakeresési konzolon a változó értékének kimenetéhez.

példa változókezelő panel

A megjelenítés szűréséhez írjon be szöveget a keresőmezőbe. A rendszer gépelés közben automatikusan szűri a listát.

A Databricks Runtime 12.2 LTS és újabb Python esetén a változók cellafuttatáskor frissülnek. Scala, R és Python esetében a Databricks Runtime 11.3 LTS-en és az alatt, a változók a cella futása után frissülnek.

Hibakereső munkamenet leállítása

A hibakeresési munkamenet befejezéséhez kattintson hibakereső leállítás gombja a cella bal felső sarkára, vagy kattintson jegyzetfüzet leállítása gomb a jegyzetfüzet tetején. A hibakeresési munkamenet 30 perc elteltével is automatikusan leáll, ha a felhasználó nem használja a hibakeresési eszköztárat vagy a hibakeresési konzolt.

Hibakeresés a Genie-kóddal

A Genie Code egy környezettudatos AI-asszisztens, amely segíthet a kód hibakeresésében. További információt a Jegyzetfüzetek Genie Code parancsikonjaiban talál.

Korlátozások

További információért tekintse meg a Databricks-jegyzetfüzetek ismert korlátozásait .