A Databricks notebook felülete és vezérlői

A jegyzetfüzet eszköztára menüket és ikonokat tartalmaz, amelyekkel kezelheti és szerkesztheti a jegyzetfüzetet.

A jegyzetfüzet neve mellett olyan gombok találhatók, amelyekkel 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.

Frissített cellaterv

Fontos

Ez a funkció a nyilvános előzetes verzióban érhető el.

Frissített cellaterv érhető el. Ez a lap a cellaterv mindkét verziójának használatáról tartalmaz információkat. Az új felhasználói felület tájolását és a gyakori kérdésekre adott válaszokat az új cella felhasználói felületének tájolása című témakörben találhatja meg.

Az új cellaterv engedélyezéséhez vagy letiltásához nyissa meg a szerkesztő beállításainak lapját a munkaterületen. Az oldalsávon kattintson a Fejlesztőeszközök elemre. A Kísérleti funkciók területen váltsa ki az Új cella felhasználói felületét.

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 a cella végrehajtásakor szöveggé és ábrává válik, és a kód dokumentálására vagy szemléltetésére használható. A munka strukturálásához cellákat vehet fel vagy távolíthat el a jegyzetfüzetből.

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

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

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 választót. Amikor a jegyzetfüzet fürthöz vagy SQL-raktárhoz csatlakozik, ez a gomb megjeleníti a számítási erőforrás nevét.
	Feladatütemező megnyitása.
	Nyissa meg a Delta Élő táblákat. Ez a gomb csak akkor jelenik meg, ha a jegyzetfüzet egy Delta Live Tables-folyamat része.
	Engedélyek megnyitása párbeszédpanel.

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
	Jegyzetfüzet-megjegyzések megnyitása.
	Nyissa meg az MLflow-jegyzetfüzet kísérletét.
	Nyissa meg a jegyzetfüzet verzióelőzményeit.
	Nyissa meg a változókezelő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ódtárat megjeleníti, beleértve a databricks-futtatókörnyezetben található jegyzetfüzet-hatókörű kódtárakat, fürttárakat és kódtárakat. Csak akkor érhető el, ha a jegyzetfüzet egy fürthöz van csatolva.

Adatok tallózása

Fontos

Ez a funkció a nyilvános előzetes verzióban érhető el.

A jegyzetfüzetben használható táblák és kötetek megismeréséhez kattintson a jegyzetfüzet bal oldalán a sémaböngésző megnyitásához. További részletekért tekintse meg az Adatok tallózása című témakört.

Cellaműveletek menü

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. A menü más megjelenésű az eredeti felhasználói felületen és az új felhasználói felületen. Ez a szakasz mindkét verzióra vonatkozó utasításokat tartalmaz.

Ha a Databricks Assistant engedélyezve van a munkaterületen, használhatja egy kódcellában, hogy segítséget vagy javaslatokat kapjon a kódhoz. Ha meg szeretne nyitni egy Databricks Assistant szövegdobozt egy cellában, kattintson a Databricks Assistant ikonra a cella jobb felső sarkában.

A cella nyelvét a cella jobb felső sarkában található Cellanyelv gombbal egyszerűen módosíthatja a kód és a markdown között, vagy módosíthatja a kódcellák nyelvét.

Cellaműveletek menü (eredeti felhasználói felület)

Ebben a menüben kódcellák is futtathatók:

A cellaműveleti menü olyan gombokat is tartalmaz, amelyekkel elrejthet vagy törölhet egy cellát.

Markdown-cellák esetén lehetőség van a cella irányítópulthoz való hozzáadására is. További információ: Irányítópultok a jegyzetfüzetekben.

Cellák használata az új felhasználói felületen

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

Nyelvválasztó: Válassza ki a cella nyelvét.

Databricks Assistant: Engedélyezze vagy tiltsa le a Databricks Assistantet a cellában található kódjavaslatokhoz.

Cellafókusz: A cella nagyításával egyszerűbbé teheti a szerkesztést.

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

Ha kódcellákat szeretne futtatni az új felhasználói felületen, kattintson a kódcella bal felső sarkában lévő lefelé mutató nyílra.

A cella futtatása után 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 a futtatás időtartamát. További részletekért vigye a kurzort az értesítés fölé.

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üben. További információ: Irányítópultok a jegyzetfüzetekben.

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.

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.

Ha felfelé vagy lefelé szeretne mozgatni egy cellát, kattintson és tartsa lenyomva a cella bal felső sarkán kívül, és húzza a cellát az új helyre. A Cellaműveletek menüben az Áthelyezés felfelé vagy lefelé lehetőséget is választhatja.

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:

Cella létrehozása (eredeti felhasználói felület)

Ha új cellát szeretne létrehozni az eredeti felhasználói felületen, mutasson egy cellára a tetején vagy alján, és kattintson az ikonra. Használhatja a jegyzetfüzetcella menüjét is: kattintson és válassza a Cella hozzáadása fent vagy a Cella hozzáadása alul lehetőséget.

Kódcellák esetén csak írja be a kódot a cellába. Markdown-cella létrehozásához válassza a Markdownt a cella nyelvi gombjáról, vagy írja be %md a cella tetején.

Cella létrehozása (új felhasználói felület)

Ha új cellát szeretne létrehozni az új felhasználói felületen, vigye az egérmutatót a felső vagy az alsó cellára. Kattintson a Kód vagy Szöveg elemre egy kód vagy Markdown-cella létrehozásához.

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 a Safari böngészőt használja, csak a billentyűparancsok érhetők el.

• Az eredeti felhasználói felületen vagy az új felhasználói felületen található cellaműveletek menüben válassza a Cella kivágása vagy a Cella másolása lehetőséget.
• Billentyűparancsok használata: Command-XCtrl-X kivágás és Command-CCtrl-C másolás.
• Használja a jegyzetfüzet tetején található Szerkesztés menüt. Válassza a Kivágás vagy a Másolás lehetőséget.

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-Va . 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 a menübeállításokat a Kivágott cellák szerkesztése > vagy a Visszavonás szerkesztése > illessze be a cellákat.

A szomszédos cellák kijelöléséhez kattintson egy Markdown-cellára, majd a Shift + Fel vagy Le billentyűkombinációval jelölje ki a fölötte vagy alatta lévő cellákat. A szerkesztési menüvel csoportként másolhatja, kivághatja, beillesztheti vagy törölheti a kijelölt cellákat. Ha az összes cellát ki szeretné jelölni, válassza a Szerkesztés > az összes cella kijelölése lehetőséget, vagy használja a parancsmód parancsikonja, a Cmd+A parancsot.

Jegyzetfüzet tartalomjegyzéke

Az automatikusan létrehozott tartalomjegyzék megjelenítéséhez kattintson a jegyzetfüzet bal felső részén található ikonra (a bal oldali oldalsáv és a legfelső cella között). A tartalomjegyzék a jegyzetfüzetben használt Markdown-címsorokból jön létre. Ha az új felhasználói felületet használja, a címekkel rendelkező cellák is megjelennek a tartalomjegyzékben.

Cellamegjelenítési beállítások

A jegyzetfüzetekhez három megjelenítési lehetőség áll rendelkezésre. A Nézet menüvel módosíthatja a megjelenítési beállítást.

• Standard nézet: az eredmények közvetlenül a kódcellák után jelennek meg.
• Csak eredmények: csak az eredmények jelennek meg.
• Egymás mellett: a kód- és eredménycellák egymás mellett jelennek meg.

Az új felhasználói felületen műveletek érhetők el a cellacsatorna ikonjaiból (a cella jobb és bal oldalán lévő területről). Ha például felfelé vagy lefelé szeretne mozgatni egy cellát, használja a bal oldali ereszcsatorna fogó pontjait . Cella törléséhez használja a kuka ikont a jobb oldali csatornában.

A könnyebb szerkesztés érdekében kattintson a fókusz mód ikonra a cella teljes szélességű megjelenítéséhez. A fókusz módból való kilépéshez kattintson a gombra. A nézet középre igazításának kikapcsolásával > a cella megjelenített szélességét is megnövelheti.

Ha a jegyzetfüzet összes celláját automatikusan szabványos vonalhosszra és térközre szeretné formázni, válassza a Jegyzetfüzet formázása szerkesztése > lehetőséget.

Sor- és parancssori számok

A vonalszámok vagy a parancsszámok megjelenítéséhez vagy elrejtéséhez válassza a Vonalszámok vagy a Parancsszámok lehetőséget a Nézet menüből. Vonalszámok esetén a Control+L billentyűparancsot is használhatja.

Ha engedélyezi a sor- vagy parancssori számokat, a Databricks menti a beállításokat, és megjeleníti őket a böngésző összes többi jegyzetfüzetében.

Vonal- és parancssori számok (eredeti felhasználói felület)

A cellák fölötti parancsszámok az adott parancsra hivatkoznak. Ha egy cella parancsszámára kattint, az frissíti az URL-címet, hogy az az adott parancshoz legyen rögzítve. Ha egy adott parancsra mutató URL-hivatkozást szeretne lekérni a jegyzetfüzetben, kattintson a jobb gombbal a parancsszámra, és válassza a Hivatkozáscím másolása parancsot.

Sor- és parancssori számok (új felhasználói felület)

A vonalszámok alapértelmezés szerint ki vannak kapcsolva az új felhasználói felületen. A bekapcsolásukhoz válassza a Vonalszámok megtekintése lehetőséget>. Ha egy cella hibaállapotban van, a kijelöléstől függetlenül sorszámok jelennek meg.

A parancsszámok váltásához válassza a Parancsszámok megtekintése lehetőséget>.

Az új felhasználói felület nem tartalmaz cellaparancsok hivatkozásait. Ha egy adott parancsra mutató URL-hivatkozást szeretne lekérni a jegyzetfüzetben, kattintson a fókusz mód megnyitásához, és másolja az URL-címet a böngésző címsorából. A fókusz módból való kilépéshez kattintson a gombra.

Cellacím hozzáadása

Ha címet szeretne hozzáadni egy cellához az eredeti felhasználói felületen, válassza a Cím megjelenítése lehetőséget a cellaműveletek menüben.

Ha címet szeretne hozzáadni egy cellához az új felhasználói felületen, tegye az alábbiak egyikét:

• Kattintson a cella tetejének közepén látható cellaszámra, és írja be a címet.
• Válassza a Cím hozzáadása lehetőséget a cellaműveletek menüben.

Az új felhasználói felületen a címmel rendelkező cellák megjelennek a jegyzetfüzet tartalomjegyzékében.

Jegyzetfüzetek megtekintése sötét módban

Dönthet úgy, hogy sötét módban jeleníti meg a jegyzetfüzeteket. A sötét mód be- vagy kikapcsolásához válassza a Téma megtekintése>, majd a Világos téma vagy a Sötét téma lehetőséget.

Cellatartalom elrejtése és megjelenítése

A cellatartalom cellakódból és a cella futtatásával létrehozott eredményekből áll. Elrejtheti és megjelenítheti a cellakódot és az eredményt a cella jobb felső sarkában található Cellaműveletek menü használatával.

A kapcsolódó funkciókért tekintse meg az összecsukható címsorokat.

Cellatartalom elrejtése és megjelenítése (eredeti felhasználói felület)

A cellakód vagy az eredmények elrejtéséhez kattintson és válassza a Kód elrejtése vagy az Eredmény elrejtése lehetőséget. Kiválaszthatja azt is, hogy csak a cella első sora jelenjen meg.

Rejtett cellakód vagy eredmények megjelenítéséhez kattintson a Hivatkozások megjelenítése gombra:

Cellatartalom elrejtése és megjelenítése (új felhasználói felület)

A cellakód vagy eredmények elrejtéséhez kattintson a cella jobb felső sarkában található kebab menüre , és válassza a Kód elrejtése vagy Az eredmény elrejtése lehetőséget. A cella összecsukása lehetőség kiválasztásával csak a cella első sora jeleníthető meg. Összecsukott cella kibontásához válassza a Cella kibontása lehetőséget.

A rejtett cellakód vagy eredmények megjelenítéséhez kattintson a megjelenítés ikonra: .

Összecsukható fejlécek

A Markdown-címsorokat tartalmazó cellák után megjelenő cellák összecsukhatók a címsorcellába. Ha a jegyzetfüzetben Markdown-címsorokat tartalmazó cellákat tartalmazó cellákat szeretne kibontani vagy összecsukni, válassza a Nézet menü összes címsorának összecsukása parancsát. A szakasz további része a cellák egy részhalmazának kibontását vagy összecsukását ismerteti.

A kapcsolódó funkciókkal kapcsolatban lásd a cellatartalom elrejtése és megjelenítése című témakört.

Címsorok kibontása és összecsukása (eredeti felhasználói felület)

A képen egy második szintű címsor MLflow beállítása látható, amelybe a következő két cella van összecsukva.

A címsorok kibontásához és összecsukásához kattintson az és -a + gombra.

Címsorok kibontása és összecsukása (új felhasználói felület)

A képen egy második szintű címsor MLflow beállítása látható, amelybe a következő két cella van összecsukva.

A címsorok kibontásához és összecsukásához vigye a kurzort a Markdown-cellára. Kattintson a cella bal oldalán megjelenő nyílra.

Számítási erőforrások jegyzetfüzetekhez

Ez a szakasz a jegyzetfüzet számítási erőforrásainak lehetőségeit ismerteti. Futtathat jegyzetfüzetet Egy Databricks-fürtön, vagy SQL-parancsok esetén az SQL-elemzéshez optimalizált SQL-adattárházat is használhat.

Jegyzetfüzet csatolása fürthöz

Ha egy jegyzetfüzetet fürthöz szeretne csatolni, szüksége van a CAN ATTACH TO fürtszintű engedélyre.

Fontos

Mindaddig, amíg egy jegyzetfüzet egy fürthöz van csatolva, a jegyzetfüzet CAN RUN engedélyével rendelkező felhasználók implicit engedéllyel rendelkeznek a fürt eléréséhez.

Ha jegyzetfüzetet szeretne csatolni egy fürthöz, kattintson a számítási választóra a jegyzetfüzet eszköztárában , és válasszon ki egy fürtöt a legördülő menüből.

A menüben a közelmúltban vagy éppen futó fürtök közül választhat.

Ha az összes elérhető fürt közül szeretne választani, kattintson az Egyebek...gombra. Kattintson a fürt nevére egy legördülő menü megjelenítéséhez, és válasszon ki egy meglévő fürtöt.

Új fürtöt is létrehozhat a legördülő menü Új erőforrás létrehozása elemével.

Fontos

A csatolt jegyzetfüzetekben a következő Apache Spark-változók vannak definiálva.

Osztály	Változó neve
SparkContext	sc
SQLContext/HiveContext	sqlContext
SparkSession (Spark 2.x)	spark

Ne hozzon létre SparkSession, SparkContextvagy SQLContext. Ez inkonzisztens viselkedéshez vezet.

Jegyzetfüzet használata SQL-raktárral

Ha egy jegyzetfüzet egy SQL-raktárhoz van csatolva, sql- és Markdown-cellákat futtathat. Ha bármilyen más nyelven (például Python vagy R) futtat egy cellát, az hibát jelez. Az SQL-raktáron végrehajtott SQL-cellák megjelennek az SQL Warehouse lekérdezési előzményeiben. A lekérdezést végrehajtó felhasználó a kimenet alján lévő eltelt időre kattintva megtekintheti a jegyzetfüzet lekérdezési profilját .

A jegyzetfüzetek futtatásához pro- vagy kiszolgáló nélküli SQL-raktárra van szükség. Hozzáféréssel kell rendelkeznie a munkaterülethez és az SQL Warehouse-hoz.

A widgetek másképp működnek, ha egy jegyzetfüzet egy SQL-raktárhoz van csatolva. További részletekért lásd : Databricks-vezérlők használata SQL-raktáron.

Jegyzetfüzet SQL-raktárhoz való csatolásához tegye a következőket:

1. Kattintson a számítási választóra a jegyzetfüzet eszköztárán. A legördülő menüben az aktuálisan futó vagy a közelmúltban használt számítási erőforrások láthatók. Az SQL-raktárak jelölése a következővel van megjelölve: .

2. A menüben válasszon ki egy SQL Warehouse-t.

   Az összes elérhető SQL-raktár megtekintéséhez válassza az Egyebek... lehetőséget a legördülő menüben. Megjelenik egy párbeszédpanel, amelyen a jegyzetfüzethez elérhető számítási erőforrások láthatók. Válassza az SQL Warehouse lehetőséget, válassza ki a használni kívánt raktárat, és kattintson a Csatolás gombra.

   

Sql-tárolót is kiválaszthat számítási erőforrásként egy SQL-jegyzetfüzethez munkafolyamat vagy ütemezett feladat létrehozásakor.

Az SQL-raktárak korlátozásai a következők:

• SQL-tárházhoz csatlakoztatva a végrehajtási kontextusoknak 8 óra az üresjárati időkorlátja.
• A visszaküldött eredmények maximális mérete 10 000 sor vagy 2 MB, attól függően, hogy melyik a kisebb.

Jegyzetfüzet leválasztása

Ha le szeretne választani egy jegyzetfüzetet egy számítási erőforrásról, kattintson a jegyzetfüzet eszköztárában található számítási választóra, és mutasson a csatolt fürtre vagy SQL Warehouse-ra a listában egy oldalsó menü megjelenítéséhez. Az oldalsó menüben válassza a Leválasztás lehetőséget.

A jegyzetfüzeteket leválaszthatja a fürtökről a Fürt részletei lap Jegyzetfüzetek lapján.

Ha leválaszt egy jegyzetfüzetet, a végrehajtási környezet el lesz távolítva, és az összes számított változó értéke törlődik a jegyzetfüzetből.

Tipp.

Az Azure Databricks azt javasolja, hogy válassza le a nem használt jegyzetfüzeteket a fürtökről. Ezzel memóriaterületet szabadít fel az illesztőprogramon.

Webes terminál és Databricks parancssori felület használata

A webes terminál jegyzetfüzetben való megnyitásához kattintson a jobb oldali oldalsáv aljára.

A Databricks parancssori felületének használata webes terminálban

A Databricks Runtime 15.0-tól kezdve használhatja a Databricks PARANCSSOR-t a jegyzetfüzet webes termináljáról.

Követelmények

• A jegyzetfüzetet egy fürthöz kell csatolni egyetlen felhasználóvalvagy nincs elkülönítési megosztott hozzáférési módban.
• A parancssori felület nem érhető el a Private Linkhez engedélyezett munkaterületeken.

A telepített parancssori felület mindig a legújabb verzió. A hitelesítés az aktuális felhasználón alapul.

A parancssori felület nem használható jegyzetfüzetcellából. A jegyzetfüzethez hasonló %sh databricks ... parancsok nem működnek a Databricks Runtime 15.0-s vagy újabb verziójával.