Jupyter-jegyzetfüzetek futtatása a munkaterületen
Ez a cikk bemutatja, hogyan futtathatja Jupyter-jegyzetfüzeteit az Azure Machine Learning Studio munkaterületén. A jegyzetfüzetet más módokon is futtathatja: Jupyter, JupyterLab és Visual Studio Code. A VS Code Desktop konfigurálható a számítási példány eléréséhez. Vagy használja a VS Code-ot a weben, közvetlenül a böngészőből, a szükséges telepítések és függőségek nélkül.
Tipp.
Javasoljuk, hogy próbálja ki a WEBES VS Code-ot, hogy kihasználhassa az általa biztosított egyszerű integrációs és gazdag fejlesztési környezetet. A VS Code for the Web számos olyan funkciót kínál a VS Code Desktopban, amelyet szeret, beleértve a keresés és a szintaxis kiemelését a böngészés és a szerkesztés során. A VS Code Desktop és a VS Code webes használatáról további információt az Azure Machine Learningbe integrált Visual Studio Code indítása és a számítási példányhoz távolról csatlakoztatott VS Code használata című témakörben talál.
Függetlenül attól, hogy melyik megoldást használja a jegyzetfüzet futtatásához, a munkaterület összes fájljához hozzáférhet. A fájlok , köztük a jegyzetfüzetek létrehozásával és kezelésével kapcsolatos információkért lásd : Fájlok létrehozása és kezelése a munkaterületen.
Ez a cikk a jegyzetfüzet közvetlenül a studióban való futtatásának élményét mutatja be.
Fontos
Az előzetes verzióként megjelölt funkciók szolgáltatásszint-szerződés nélkül érhetők el, és éles számítási feladatokhoz nem ajánlott. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.
Előfeltételek
- Azure-előfizetés. Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
- Egy Machine Learning-munkaterület. Lásd: Munkaterület-erőforrások létrehozása.
- A felhasználói identitásnak hozzá kell férnie a munkaterület alapértelmezett tárfiókjához. Attól függ, hogy tud-e jegyzetfüzeteket olvasni, szerkeszteni vagy létrehozni, attól függ, hogy milyen hozzáférési szinttel rendelkezik a munkaterületen. A közreműködők például szerkeszthetik a jegyzetfüzetet, míg az olvasók csak megtekinthetik.
Jegyzetfüzetek elérése a munkaterületről
A munkaterület Jegyzetfüzetek szakaszával szerkesztheti és futtathatja a Jupyter-jegyzetfüzeteket.
- Bejelentkezés az Azure Machine Learning Studióba
- Jelölje ki a munkaterületet, ha még nincs megnyitva
- A bal oldalon válassza a Jegyzetfüzetek lehetőséget
Jegyzetfüzet szerkesztése
Jegyzetfüzet szerkesztéséhez nyissa meg a munkaterület Felhasználói fájlok szakaszában található jegyzetfüzeteket. Jelölje ki a szerkeszteni kívánt cellát. Ha ebben a szakaszban nincs jegyzetfüzete, tekintse meg a munkaterület fájljainak létrehozását és kezelését.
A jegyzetfüzetet anélkül szerkesztheti, hogy egy számítási példányhoz csatlakozik. Ha futtatni szeretné a cellákat a jegyzetfüzetben, válasszon ki vagy hozzon létre egy számítási példányt. Ha egy leállított számítási példányt választ, az automatikusan elindul az első cella futtatásakor.
Amikor egy számítási példány fut, az Intellisense által működtetett kódkiegészítést is használhatja bármely Python-jegyzetfüzetben.
Amikor egy számítási példány fut, elindíthatja a Jupytert vagy a JupyterLabet a jegyzetfüzet eszköztárából. Az Azure Machine Learning nem biztosít frissítéseket és kijavítja a Jupyter vagy a JupyterLab hibáit, mivel azok nyílt forráskódú termékek a Microsoft ügyfélszolgálata határain kívül.
Fókusz mód
A fókusz mód használatával bontsa ki az aktuális nézetet, hogy az aktív fülekre összpontosíthasson. A Fókusz mód elrejti a Jegyzetfüzetek fájlkezelőt.
A terminálablak eszköztárán válassza a Fókusz mód lehetőséget a fókusz mód bekapcsolásához. Az ablak szélességétől függően előfordulhat, hogy az eszköz az eszköztár ... menüeleme alatt található.
Fókusz módban térjen vissza a standard nézethez a Standard nézet kiválasztásával.
Kódkiegészítés (IntelliSense)
Az IntelliSense egy kódkiegészítési segéd, amely számos funkciót tartalmaz: Listatagok, Paraméteradatok, Gyors információ és Teljes Word. Csak néhány billentyűleütéssel:
- További információ a használt kódról
- Kövesse nyomon a beírt paramétereket
- Hívások hozzáadása tulajdonságokhoz és metódusokhoz
Jegyzetfüzet megosztása
Az Ön jegyzetfüzetei a munkaterülete tárfiókjában vannak tárolva, és megoszthatók másokkal, az Ön munkaterületéhez való hozzáférési szintjüktől függően. Megnyithatják és szerkeszthetik a jegyzetfüzetet, amíg megfelelő hozzáféréssel rendelkeznek. A közreműködők például szerkeszthetik a jegyzetfüzetet, míg az olvasók csak megtekinthetik.
A munkaterületének többi felhasználója az Azure Gépi Tanulás studió Jegyzetfüzetek, Felhasználói fájlok szakaszában találja meg a jegyzetfüzetet. A jegyzetfüzetek alapértelmezés szerint az Ön felhasználónevét viselő mappában találhatók, és ott mások is elérhetik őket.
Az URL-címet a böngészőjéből is kimásolhatja, amikor megnyit egy jegyzetfüzetet, majd elküldheti másoknak. Amennyiben ők megfelelő hozzáféréssel rendelkeznek a munkaterülethez, megnyithatják a jegyzetfüzetet.
Mivel nem oszt meg számítási példányokat, a jegyzetfüzetet futtató többi felhasználó saját számítási példányt fog használni.
Együttműködés jegyzetfüzet-megjegyzésekkel
Jegyzetfüzet-megjegyzés használatával együttműködhet másokkal, akik hozzáférnek a jegyzetfüzethez.
Kapcsolja be és ki a megjegyzések panelt a jegyzetfüzet tetején található Jegyzetfüzet megjegyzések eszközével. Ha a képernyő nem elég széles, keresse meg ezt az eszközt az eszközkészlet végén található ... elem kiválasztásával.
Függetlenül attól, hogy a megjegyzések panel látható-e vagy sem, bármely kódcellába felvehet megjegyzést:
- Jelöljön ki egy szöveget a kódcellában. Csak a kódcellákban lévő szöveghez fűzhet megjegyzést.
- A megjegyzés létrehozásához használja az Új megjegyzésszál eszközt.
- Ha a megjegyzések panel korábban rejtve volt, most megnyílik.
- Írja be a megjegyzést, és tegye közzé az eszközzel, vagy használja a Ctrl+Enter billentyűkombinációt.
- Miután közzétett egy megjegyzést, válassza a ... lehetőséget a jobb felső sarokban a következőhöz:
- A megjegyzés szerkesztése
- A szál feloldása
- A szál törlése
A megjegyzéssel ellátott szöveg lila kiemeléssel jelenik meg a kódban. Amikor kijelöl egy megjegyzést a megjegyzések panelen, a jegyzetfüzet a kijelölt szöveget tartalmazó cellához görget.
Feljegyzés
A megjegyzések a kódcella metaadataiba lesznek mentve.
A jegyzetfüzet tisztítása (előzetes verzió)
A jegyzetfüzet létrehozása során általában az adatfeltáráshoz vagy hibakereséshez használt cellákat használja. A gyűjtés funkció segítségével tiszta jegyzetfüzetet hozhat létre ezek nélkül a felesleges cellák nélkül.
- Futtassa az összes jegyzetfüzetcellát.
- Jelölje ki azt a kódot tartalmazó cellát, amely az új jegyzetfüzetet futtatni szeretné. Például a kísérletet beküldő kód, vagy a modellt regisztráló kód.
- Válassza a cella eszköztárán megjelenő Összegyűjtés ikont.
- Adja meg az új "összegyűjtött" jegyzetfüzet nevét.
Az új jegyzetfüzet csak kódcellákból áll, és az összes olyan cella, amely a gyűjtéshez kiválasztott cellával azonos eredményt hoz létre.
Jegyzetfüzet mentése és ellenőrzése
Az Azure Machine Learning létrehoz egy ellenőrzőpontfájlt egy ipynb-fájl létrehozásakor.
A jegyzetfüzet eszköztárában válassza ki a menüt, majd a Fájl>mentése és az ellenőrzőpont lehetőséget a jegyzetfüzet manuális mentéséhez, és hozzáad egy, a jegyzetfüzethez társított ellenőrzőpontfájlt.
Minden jegyzetfüzet automatikusan 30 másodpercenként lesz mentve. Az automatikus mentés csak a kezdeti ipynb fájlt frissíti, az ellenőrzőpontfájlt nem.
A jegyzetfüzet menüjében az Ellenőrzőpontok lehetőséget választva létrehozhat egy elnevezett ellenőrzőpontot, és visszaállíthatja a jegyzetfüzetet egy mentett ellenőrzőpontra.
Jegyzetfüzet exportálása
A jegyzetfüzet eszköztárán válassza ki a menüt, majd exportálja a jegyzetfüzetet a támogatott típusok bármelyikeként:
- Python
- HTML
- Latex
Az exportált fájl a számítógépre lesz mentve.
Jegyzetfüzet vagy Python-szkript futtatása
Jegyzetfüzet vagy Python-szkript futtatásához először egy futó számítási példányhoz kell csatlakoznia.
Ha nincs számítási példánya, az alábbi lépésekkel hozhat létre egyet:
- A jegyzetfüzet vagy a szkript eszköztárában, a Compute legördülő menü jobb oldalán válassza az + Új számítás lehetőséget. A képernyő méretétől függően előfordulhat, hogy a vezérlő egy ... menü alatt található.
- Nevezze el a számítást, és válasszon egy virtuálisgép-méretet.
- Válassza a Létrehozás lehetőséget.
- A számítási példány automatikusan csatlakozik a fájlhoz. Most már futtathatja a jegyzetfüzetcellát vagy a Python-szkriptet a számítási példánytól balra található eszközzel.
- A jegyzetfüzet vagy a szkript eszköztárában, a Compute legördülő menü jobb oldalán válassza az + Új számítás lehetőséget. A képernyő méretétől függően előfordulhat, hogy a vezérlő egy ... menü alatt található.
Ha leállított számítási példánya van, válassza a Számítás indítása elemet a Számítási legördülő lista jobb oldalán. A képernyő méretétől függően előfordulhat, hogy a vezérlő egy ... menü alatt található.
Miután csatlakozott egy számítási példányhoz, az eszköztár használatával futtassa a jegyzetfüzet összes celláját, vagy a Control + Enter billentyűkombinációt egyetlen kijelölt cella futtatásához.
Csak Ön láthatja és használhatja a létrehozott számítási példányokat. A felhasználói fájlok a géptől külön vannak tárolva, és a munkaterület összes számítási példánya között meg vannak osztva.
Változók felfedezése a jegyzetfüzetben
A jegyzetfüzet eszköztárán a Változókezelő eszközzel megjelenítheti a jegyzetfüzetben létrehozott összes változó nevét, típusát, hosszát és mintaértékeit.
Válassza ki az eszközt a változókezelő ablakának megjelenítéséhez.
Navigálás toc használatával
A jegyzetfüzet eszköztárán a Tartalomjegyzék eszközzel jelenítheti meg vagy rejtheti el a tartalomjegyzéket. Ha címsorral indít el egy Markdown-cellát, az hozzáadódik a tartalomjegyzékhez. Jelöljön ki egy bejegyzést a táblázatban a jegyzetfüzet adott cellájába való görgetéshez.
A jegyzetfüzet-környezet módosítása
A jegyzetfüzet eszköztárával módosíthatja a környezetet, amelyen a jegyzetfüzet fut.
Ezek a műveletek nem módosítják a jegyzetfüzet állapotát vagy a jegyzetfüzetben lévő változók értékeit:
| Művelet | Eredmény |
|---|---|
| A kernel leállítása | Leállítja a futó cellákat. A cella futtatása automatikusan újraindítja a kernelt. |
| Navigálás egy másik munkaterületszakaszra | A futó cellák leállnak. |
Ezek a műveletek alaphelyzetbe állítja a jegyzetfüzet állapotát, és alaphelyzetbe állítja a jegyzetfüzet összes változót.
| Művelet | Eredmény |
|---|---|
| A kernel módosítása | A jegyzetfüzet új kernelt használ |
| Számítás váltása | A jegyzetfüzet automatikusan az új számítást használja. |
| Számítás alaphelyzetbe állítása | Egy cella futtatásakor újra elindul |
| A számítás leállítása | Nem futnak cellák |
| Jegyzetfüzet megnyitása a Jupyterben vagy a JupyterLabban | Új lapon megnyitott jegyzetfüzet. |
Új kernelek hozzáadása
A terminál használatával hozzon létre és adjon hozzá új kerneleket a számítási példányhoz. A jegyzetfüzet automatikusan megtalálja a csatlakoztatott számítási példányra telepített összes Jupyter-kernelt.
Váltson bármelyik telepített kernelre a jobb oldali kernel legördülő listával.
Csomagok kezelése
Mivel a számítási példány több kernelből áll, mindenképpen használjon %pip vagy %conda varázsfüggvényeket, amelyek csomagokat telepítenek a jelenleg futó kernelbe. Ne használja !pip az !condaösszes csomagot (beleértve a jelenleg futó kernelen kívüli csomagokat is).
Állapotjelzők
A Compute legördülő lista melletti mutató az állapotát mutatja. Az állapot a legördülő menüben is megjelenik.
| Color | Számítási állapot |
|---|---|
| Zöld | Futtatott számítás |
| Piros | A számítás nem sikerült |
| Fekete | A számítás leállt |
| Világoskék | Számítás létrehozása, indítása, újraindítása, beállítása |
| Szürke | Számítás törlése, leállítása |
A Kernel legördülő lista melletti mutató az állapotát mutatja.
| Color | Kernel állapota |
|---|---|
| Zöld | Kernel csatlakoztatva, tétlen, foglalt |
| Szürke | A kernel nincs csatlakoztatva |
Számítási adatok keresése
A számítási példányokkal kapcsolatos részletek a Studio Compute oldalán találhatók.
Hasznos billentyűparancsok
A Jupyter Notebookokhoz hasonlóan az Azure Machine Learning Studio-jegyzetfüzetek is rendelkeznek modális felhasználói felülettel. A billentyűzet különböző műveleteket végez attól függően, hogy a jegyzetfüzetcella milyen módban van. Az Azure Machine Learning Studio-jegyzetfüzetek az alábbi két módot támogatják egy adott kódcellához: parancsmódot és szerkesztési módot.
Parancsmód billentyűparancsai
A cellák parancsmódban vannak, ha nincs szövegkurzor, amely a beírásra kéri. Ha egy cella Parancs módban van, szerkesztheti a jegyzetfüzet egészét, de nem írhat be egyes cellákba. A parancsmód megadásához nyomja ESC le vagy használja az egérrel a cella szerkesztőterületén kívülre történő kijelölést.
| Parancsikon | Leírás |
|---|---|
| Enter | Szerkesztési mód megadása |
| Shift + Enter | Cella futtatása, válassza az alábbi lehetőséget |
| Control/Command + Enter | Cella futtatása |
| Alt + Enter | Cella futtatása, kódcella beszúrása |
| Control/Command + Alt + Enter | Cella futtatása, markdown cella beszúrása lent |
| Alt+ R | Az összes futtatása |
| I | Cella átalakítása kódmá |
| H | Cella konvertálása markdown-ra |
| Fel/K | A fenti cella kijelölése |
| Le/J | Az alábbi cella kijelölése |
| A | Kódcella beszúrása fent |
| h | Kódcella beszúrása lent |
| Control/Command + Shift + A | Markdown-cella beszúrása fent |
| Control/Command + Shift + B | Markdown-cella beszúrása lent |
| X | Kijelölt cella kivágása |
| C | Kijelölt cella másolása |
| Shift +V | Kijelölt cella beillesztése fent |
| V | Kijelölt cella beillesztése lent |
| D D | Kijelölt cella törlése |
| O | Kimenet váltása |
| Shift +O | A kimenet görgetése váltása |
| Én | Kernel megszakítása |
| 0 0 | Kernel újraindítása |
| Shift + Szóköz | Görgetés felfelé |
| Szóköz | Görgessen lefelé |
| Lap | Fókusz módosítása a következő fókuszban lévő elemre (ha a tabulátor le van tiltva) |
| Control/Command + S | Jegyzetfüzet mentése |
| 0 | Váltás h1-re |
| 2 | Váltás h2-re |
| 3 | Váltás h3-ra |
| 4 | Váltás h4-re |
| 5 | Váltás h5-ösre |
| 6 | Váltás h6-ra |
Szerkesztési mód billentyűparancsai
A szerkesztési módot egy szövegkurzor jelzi, amely arra kéri, hogy írja be a szerkesztőterületet. Ha egy cella szerkesztési módban van, beírhatja a cellába. A szerkesztési mód megadásához nyomja Enter le vagy jelölje ki a cella szerkesztőterületét. A kurzort kérő üzenet szerkesztési módban jelenik meg a cellában.
Az alábbi billentyűparancsokkal könnyebben navigálhat és futtathat kódot az Azure Machine Learning-jegyzetfüzetekben szerkesztési módban.
| Parancsikon | Leírás |
|---|---|
| Menekülés | Adja meg a parancsmódot |
| Control/Command + Space | Az IntelliSense aktiválása |
| Shift + Enter | Cella futtatása, válassza az alábbi lehetőséget |
| Control/Command + Enter | Cella futtatása |
| Alt + Enter | Cella futtatása, kódcella beszúrása |
| Control/Command + Alt + Enter | Cella futtatása, markdown cella beszúrása lent |
| Alt+ R | Az összes cella futtatása |
| Fel | Kurzor áthelyezése felfelé vagy az előző cellára |
| Le | A kurzor áthelyezése lefelé vagy a következő cellára |
| Control/Command + S | Jegyzetfüzet mentése |
| Control/Command + Up | Ugrás a cella elejére |
| Control/Command + Down | Ugrás a cella végére |
| Lap | Kód befejezése vagy behúzása (ha a tabulátor engedélyezve van) |
| Control/Command + M | Tabulátor engedélyezése/letiltása |
| Control/Command + ] | Behúzás |
| Control/Command + [ | Dedent |
| Control/Command + A | Összes kijelölése |
| Control/Command + Z | Visszavonás |
| Control/Command + Shift + Z | Ismétlés |
| Control/Command + Y | Ismétlés |
| Control/Command + Home | Ugrás a cella elejére |
| Control/Command + End | Ugrás a cella végére |
| Control/Command + Left | Egy szó balra |
| Control/Command + Right | Egy szó jobbra |
| Control/Command + Backspace | Szó törlése előtt |
| Control/Command + Delete | Szó törlése utána |
| Control/Command + / | Megjegyzés váltása a cellán |
Hibaelhárítás
Csatlakozás jegyzetfüzethez: Ha nem tud csatlakozni egy jegyzetfüzethez, győződjön meg arról, hogy a websocket kommunikáció nincs letiltva. Ahhoz, hogy a számítási példány Jupyter funkciója működjön, a webes szoftvercsatornás kommunikációt engedélyezni kell. Győződjön meg róla, hogy a hálózat engedélyezi a websocket-kapcsolatokat a *.instances.azureml.net és *.instances.azureml.ms címekre.
Privát végpont: Ha egy számítási példány privát végponttal rendelkező munkaterületen van üzembe helyezve, az csak a virtuális hálózaton belülről érhető el. Ha egyéni DNS- vagy gazdagépfájlt használ, adjon hozzá egy bejegyzést a < példánynév >.< régióhoz >.instances.azureml.ms a munkaterület privát végpontjának privát IP-címével. További információért lásd az egyéni DNS témakörről szóló cikket.
Kernel összeomlása: Ha a rendszermag összeomlott és újraindult, futtassa a következő parancsot a Jupyter naplójának megtekintéséhez, és további részleteket talál:
sudo journalctl -u jupyter. Ha a kernellel kapcsolatos problémák továbbra is fennállnak, érdemes lehet több memóriával rendelkező számítási példányt használni.Lejárt token: Ha lejárt tokennel kapcsolatos problémába ütközik, jelentkezzen ki az Azure gépi tanulás studióból, majd jelentkezzen be újra, és indítsa újra a jegyzetfüzet rendszermagját.
Fájlfeltöltési korlát: A jegyzetfüzet fájlkezelőjén keresztül történő feltöltés esetén 5 TB-nál kisebb méretű fájlok feltöltésére van korlátozva. Ha ennél nagyobb méretű fájlt kell feltöltenie, javasoljuk, hogy az SDK segítségével töltse fel az adatokat egy adattárolóba. További információért lásd az Adateszközök létrehozása témakört.