Alapszintű szerkesztés a Databricks-jegyzetfüzetekben

A Databricks-jegyzetfüzet egy webes kódszerkesztő, amely lehetővé teszi a kód írását és az eredmények megtekintését interaktív adatelemzéshez. Ez a lap bemutatja a jegyzetfüzetek Databricksben való használatának alapjait, beleértve az eszköztáron való navigálást és a különböző cellaműveletek végrehajtását.

Jegyzetfüzet létrehozása

Új jegyzetfüzet létrehozásához kattintson az Új gombra a munkaterület oldalsávjának vagy Jegyzetfüzet létrehozása bármely mappában.

Jegyzetfüzet megnyitása

A jegyzetfüzet megnyitásához használja a munkaterület keresési függvényt, vagy a munkaterület böngészővel navigáljon a jegyzetfüzethez, és kattintson a jegyzetfüzet nevére vagy ikonjára.

Jegyzetfüzet cellái

A jegyzetfüzetek kétféle cellatípust tartalmaznak: kódcellákat és Markdown-cellákat. A kódcellák futtatható kódot tartalmaznak. A Markdown-cellák olyan Markdown-kódot tartalmaznak, amely szövegként és ábráként jelenik meg. A Markdown használatával dokumentálhatja vagy szemléltetheti a kódot. A jegyzetfüzetbe bármilyen típusú cellát hozzáadhat vagy eltávolíthat a munka strukturálásához.

Futtathat egyetlen cellát, cellacsoportot vagy a teljes jegyzetfüzetet. A jegyzetfüzetcellák legfeljebb 10 MB-ot tartalmazhatnak, kimenete pedig legfeljebb 20 MB lehet.

Jegyzetfüzet eszköztár ikonjai és gombjai

Az eszköztár menüket és ikonokat tartalmaz, amelyekkel kezelheti és szerkesztheti a jegyzetfüzetet.

A jegyzetfüzet neve mellett gombokkal módosíthatja a jegyzetfüzet alapértelmezett nyelvét, és ha a jegyzetfüzet szerepel a Databricks Git mappában, nyissa meg a Git párbeszédpanelt.

A jegyzetfüzet korábbi verzióinak megtekintéséhez kattintson az "Utolsó szerkesztés..." gombra. üzenet a menük jobb oldalán.

Az eszköztár jobb oldalán található ikonokat és gombokat az alábbi táblázat ismerteti:

Ikon	Leírás
	Futtassa az összes cellát, vagy állítsa le a végrehajtást. A gomb neve a jegyzetfüzet állapotától függően változik.
	Nyissa meg a számítási kiválasztót. Amikor a notebook fürthöz vagy SQL adattárházhoz kapcsolódik, ez a gomb megjeleníti a számítási erőforrás nevét.
	Nyissa meg a(z) feladatütemezőt.
	Nyissa meg DLT. Ez a gomb csak akkor jelenik meg, ha a jegyzetfüzet egy DLT-folyamat része.
	Engedélyek párbeszédpanel megnyitása.

jobb oldali oldalsávműveletek

A jegyzetfüzet jobb oldali oldalsávján számos művelet érhető el, az alábbi táblázatban leírtak szerint:

Ikon	Leírás
	Nyisd meg a jegyzetfüzet megjegyzéseit.
	Nyissa meg MLflow-jegyzetfüzet kísérletét.
	Nyissa meg a jegyzetfüzet verziótörténetét.
	Nyissa meg a változóböngészőt. (Python-változókhoz érhető el a Databricks Runtime 12.2 LTS-sel és újabb verzióval.)
	Nyissa meg a Python-környezet panelt. Ez a panel a jegyzetfüzet számára elérhető összes Python-könyvtárat megjeleníti, beleértve a jegyzetfüzeti hatókörű könyvtárakat, a fürtkönyvtárakat és a Databricks-futtatókörnyezetben található könyvtárakat. Csak akkor elérhető, ha a jegyzetfüzet egy fürthöz van csatolva.

Cellák létrehozása

A jegyzetfüzetek kétféle cellával rendelkeznek: kód és Markdown. A Markdown-cellák tartalma HTML-ben jelenik meg. Ez a kódrészlet például egy első szintű címsor jelölőjét tartalmazza:

%md ### Libraries
Import the necessary libraries.

Renderelés az ábrán látható módon:

Új cella létrehozásához vigye az egérmutatót egy felső vagy alsó cellára. Kód vagy Markdown-cella létrehozásához kattintson Kód vagy Szöveg elemre.

Cellaműveletek

A cellaműveletek menüben cellákat futtathat, kivághat és másolhat, áthelyezheti a cellákat a jegyzetfüzetben, és elrejtheti a kódot vagy az eredményeket.

Cella futtatása

A kódcellák futtatásához kattintson a kódcella bal felső sarkában található lefelé mutató nyílra.

Miután egy cella lefutott, megjelenik egy értesítés a cellafuttatási menü jobb oldalán, amely megjeleníti a cella utolsó futtatásának időpontját és időtartamát. További részletekért vigye a kurzort az értesítés fölé.

Ha alapértelmezés szerint részletes futtatási információkat szeretne megjeleníteni, kattintson a profilképére a jobb felső sarokban. Ezután kattintson a Beállítások>Fejlesztői>Részletes parancsfuttatási információk megjelenítéseelemre.

Ha táblázatos eredménykimenettel rendelkezik, ezt az információt úgy is elérheti, hogy a felhasználói felület "Utolsó frissítés" szakaszára mutat.

Kijelölt cellák futtatása

Egyetlen cellát vagy cellagyűjteményt is futtathat. Ha egyetlen cellát szeretne kijelölni, kattintson a cellán belül bárhová. Ha több cellát szeretne kijelölni, tartsa lenyomva a Command billentyűt MacOS rendszeren vagy a Windows Ctrl kulcsát, és kattintson a szövegterületen kívüli cellára a képernyőképen látható módon.

A kijelölt cellák futtatásához, kattintson a Futtatás>Futtatás és hibakeresés>Kijelölt cellák futtatása, vagy használja a billentyűparancsot Command + Enter MacOS-en vagy Windows rendszeren Crtl + Enter. A parancs viselkedése attól függ, hogy a jegyzetfüzet milyen számítási erőforráshoz van csatolva.

• A Databricks Runtime 13.3 LTS-t vagy újabb verziót futtató számítási erőforráson a kijelölt cellák egyenként lesznek végrehajtva. Ha hiba történik egy cellában, a végrehajtás a következő cellákkal folytatódik.
• A Databricks Runtime 14.0-s vagy újabb verzióját futtató számítási erőforráson vagy SQL-raktáron a kijelölt cellák kötegként lesznek végrehajtva. Minden hiba leállítja a végrehajtást, és nem szakíthatja meg az egyes cellák végrehajtását. A Megszakítás gombbal leállíthatja az összes cella végrehajtását.

Kijelölt szöveg futtatása

A jegyzetfüzetcellákban kiemelheti a kódot vagy az SQL-utasításokat, és csak a kiemelt kódot futtathatja. Ez akkor hasznos, ha gyorsan szeretné iterálni a kódot és a lekérdezéseket.

1. Jelölje ki a futtatni kívánt sorokat.

2. Válassza a(z) >, vagy használja a(z) billentyűparancsot: Ctrl+Shift+Enter. Ha nincs kijelölve szöveg, Kijelölt szöveg futtatása végrehajtja az aktuális sort.

   

Ha vegyes nyelveket használ egy cellában, a kijelölésbe bele kell foglalnia a %<language> sort.

Kijelölt szöveg futtatása a kijelölésben lévő összecsukott kódot is végrehajtja, ha van ilyen.

Speciális cellaparancsok, például %run, %pipés %sh támogatottak.

Nem használható Kijelölt szöveg futtatása több kimeneti fület tartalmazó cellákon (vagyis olyan cellákon, ahol adatprofilt vagy vizualizációt definiált).

Cellaikonok

Az alábbi képernyőkép a jegyzetfüzetcella jobb felső sarkában megjelenő ikonokat ismerteti:

Nyelvválasztó: A cella nyelvének kiválasztása.

Databricks Assistant: A Databricks Assistant engedélyezése vagy letiltása a cellában található kódjavaslatokhoz.

Cellafókusz: A cella nagyítása a szerkesztés megkönnyítése érdekében.

Cellaműveletek menüjének megjelenítése: A cellaműveletek menüjének megnyitása. A menüben található beállítások kissé eltérnek a kód és a Markdown-cellák esetében.

Cella törlése

Cella törléséhez kattintson a cella jobb oldalán található kuka ikonra. Ez az ikon csak akkor jelenik meg, ha a kurzort a cellára viszi.

Cella áthelyezése

Ha felfelé vagy lefelé szeretne mozgatni egy cellát, kattintson és tartsa lenyomva a húzásra szolgáló ikont a cella bal oldalán.

A cellaműveletek menüben a Feljebb vagy a Lejjebb lehetőségek közül is választhat.

Cellák kivágása, másolása és beillesztése

A cellák kivágására és másolására több lehetőség is van. Ha azonban a Safari böngészőt használja, csak a billentyűparancsok érhetők el.

• A Cellaműveletek menüben válassza a Cella kivágása vagy Cella másolásalehetőséget.
• Billentyűparancsok használata: Command-X vagy Ctrl-X kivágáshoz és Command-C vagy Ctrl-C másoláshoz.
• Használja a jegyzetfüzet tetején található Szerkesztés menüt. Válassza a Kivágást vagy a Másolást.

A cellák kivágása vagy másolása után beillesztheti ezeket a cellákat a jegyzetfüzet más részébe, egy másik jegyzetfüzetbe vagy egy másik böngészőlapra vagy -ablakba. Cellák beillesztéséhez használja a billentyűparancsot Command-V vagy Ctrl-V. A cellák az aktuális cella alá vannak beillesztve.

A kivágási vagy beillesztési műveletek visszavonásához használhatja a billentyűparancsot Command-Z vagy Ctrl-Z, illetve a menüopciókat: Szerkesztés > Vágott cellák visszavonása vagy Szerkesztés > Beillesztett cellák visszavonása.

A szomszédos cellák kijelöléséhez kattintson egy Markdown-cellára, majd Shift + Fel vagy Lefelé a fölötte vagy alatta lévő cellák kijelöléséhez. A szerkesztési menüvel csoportként másolhatja, kivághatja, beillesztheti vagy törölheti a kijelölt cellákat. Az összes cella kijelöléséhez válassza a Szerkesztés > Jelölje ki az összes cellát, vagy használja a parancsmód parancsikont Cmd+A.

Kódbejegyzések hozzáadása

Ha megjegyzést szeretne hozzáadni egy cellában lévő kódhoz, jelölje ki a kódot. A cella jobb oldalán megjelenik egy megjegyzés ikon. Kattintson az ikonra a megjegyzésmező megnyitásához.

Cella hozzáadása irányítópulthoz

Ha egy Markdown-cellát vagy táblázatos eredményt tartalmazó cellát szeretne hozzáadni egy irányítópulthoz, válassza a Hozzáadás az irányítópulthoz lehetőséget a cellaműveletek menüből. További információ: irányítópultok a jegyzetfüzetekben.

Hivatkozás egy cellára

Ha egy adott parancsra mutató URL-hivatkozást szeretne lekérni a jegyzetfüzetben, kattintson a fókusz mód megnyitásához és az URL-cím másolásához a böngésző címsorából. A fókusz módból való kilépéshez kattintson .

A Databricks Assistant megnyitása

Ha meg szeretne nyitni egy Databricks Assistant szövegdobozt egy cellában, kattintson a Databricks Assistant ikonra a cella jobb felső sarkában.

Egy kódcellában is használhatja, hogy segítséget vagy javaslatokat kapjon a kódhoz. A Databricks Assistantet engedélyezni kell a munkaterületen.