Alapszintű szerkesztés a Databricks-jegyzetfüzetekben

A Databricks-jegyzetfüzet egy webalapú kódszerkesztő, amely lehetővé teszi a kód írását és az eredmények megtekintését az interaktív adatelemzés során. Az eszköztár és a cellaműveletek segítségével cellákat hozhat létre, futtathat, rendszerezhet és szerkeszthet, beleértve két jegyzetfüzet egymás melletti szerkesztését is.

Jegyzetfüzet létrehozása

Többféleképpen is létrehozhat új jegyzetfüzetet:

• Az Oldalsáv Új gombjának használata
• Jegyzetfüzet létrehozása bármely mappában
• Jegyzetfüzet létrehozása új lapon

Új jegyzetfüzet létrehozásakor a rendszer az otthoni munkaterület egy Drafts mappájába menti. Miután elnevezte a jegyzetfüzetet, az az Drafts mappából átkerül az otthoni munkaterület mappájába.

Jegyzetfüzet megnyitása

Jegyzetfüzet megnyitásához használja a munkaterület Keresés funkcióját , vagy a munkaterület böngészőjét használva keresse meg a jegyzetfüzetet , és kattintson a jegyzetfüzet nevére vagy ikonra.

Ha engedélyezve van a jegyzetfüzetek és fájlok lapja, megnyithat egy jegyzetfüzetet egy új lapon.

Jegyzetfüzetek egymás melletti szerkesztése

A jegyzetfüzetek egymás melletti megtekintéséhez és szerkesztéséhez kattintson az Az aktuális jegyzetfüzet osztott nézetének hozzáadásához. A jegyzetfüzet fülét jobbra húzva egymás mellett szerkesztheti a jegyzetfüzeteket.

Jegyzetfüzetcellák

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. Egy jegyzetfüzet legfeljebb 10 000 cellát tartalmazhat.

Futtathat egyetlen cellát, egy cellacsoportot, vagy az egész jegyzetfüzetet. A jegyzetfüzetcellák legfeljebb 6 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:

Icon	Description
	Futtassa az összes cellát vagy állítsa le a futtatá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 a Lakeflow-folyamatokat. Ez a gomb csak akkor jelenik meg, ha a jegyzetfüzet egy 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:

Icon	Description
	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 databricks runtime 12.2 LTS és újabb verziójú változókhoz érhető el.)
	Nyissa meg a Python környezeti panelt. Ez a panel a jegyzetfüzethez elérhető összes Python könyvtárat megjeleníti, beleértve a jegyzetfüzet-hatókörű könyvtárakat, a fürtkönyvtárakat és a Databricks Runtime-ban 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.

Új cella létrehozásához vigye az egérmutatót egy felső vagy alsó cellára, és kattintson az alábbiak egyikére:

• + Kód egy kódcella hozzáadásához.
• + Szöveg Markdown-cella hozzáadásához.
• + Genie Code egy beágyazott Genie Code-üzenettel rendelkező kódcella hozzáadásához. Írja le, hogy mit szeretne, és a Genie Code létrehozza a kódot az új cellában.

Alapértelmezés szerint a kódcella a jegyzetfüzet kódnyelvét feltételezi, amely az oldal tetején van megadva. Ha nyelveket szeretne keverni, megadhat egy másik nyelvet egy cellához. Lásd: Alapértelmezett nyelv beállítása.

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:

Cella műveletek

A cellákon különböző műveleteket hajthat végre. A cellafuttatási menüben kiválaszthatja, hogy egy cellát, a fölötte lévő összes cellát vagy az alatta lévő összes cellát futtatni szeretne-e. Vannak cellaikonok, amelyek lehetővé teszik a kódnyelv gyors módosítását, egy cella törlését és a Genie Code elérését. A Cellaműveletek menüben kivághatja és másolhatja a cellákat, áthelyezheti a cellákat a jegyzetfüzetben, és elrejtheti a kódot vagy az eredményeket egy cellán belül.

Cella futtatása

Kódcella futtatásához kattintson a cella bal felső sarkában található jobbra mutató nyílra. A cellafuttatási menü eléréséhez kattintson a mellette lévő lefelé mutató nyílra, és válassza ki a környezetet a cella futtatásához.

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 táblázat jobb alsó sarkában az "Utolsó frissítés" szövegre 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 Run>Futtatás és hibakeresés> Kiválasztott cellák futtatása vagy használja a Command + Enter billentyűparancsot MacOS-en, illetve a Ctrl + Enter billentyűparancsot Windows-on. 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.

A kijelölt szöveg futtatása nem használható több kimeneti fület tartalmazó cellákon (vagyis olyan cellákon, amelyekben 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.

Cella törlése: Törölje a cellát.

Genie-kód: Váltás a Genie Code inline megnyitására vagy bezárására a kódcellában. Megadhat egy utasítást a Genie Code számára, hogy segítsen kódot generálni.

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 fel vagy le szeretne mozgatni egy cellát, kattintson és tartsa lenyomva a cellától balra lévő húzóikont

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ókért lásd: Az irányítópultok a Databricks notebookokban.

Hivatkozás egy cellára

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

Genie-kód megnyitása

A Genie Code kétféleképpen nyitható meg:

• Egy meglévő cellában: kattintson a cella jobb felső sarkában található Genie Code ikonra .
• Új cellában: vigye az egérmutatót egy cellára a tetején vagy alján, és kattintson a + Genie Code elemre. Részletekért lásd a Cellák létrehozása című témakört.

A Genie Code használatával egy kódcellában segítséget vagy javaslatokat kaphat a kódhoz. A Genie Code-ot engedélyezni kell a munkaterületen.