Jupyter-notebooks uitvoeren in uw werkruimte

Meer informatie over het rechtstreeks uitvoeren van uw Jupyter-notebooks in uw werkruimte in Azure Machine Learning-studio. Hoewel u Jupyter of JupyterLab kunt starten, kunt u uw notitieblokken ook bewerken en uitvoeren zonder de werkruimte te verlaten.

Zie Bestanden maken en beheren in uw werkruimte voor meer informatie over het maken en beheren van bestanden, inclusief notitieblokken.

Belangrijk

Functies die zijn gemarkeerd als (preview) worden geleverd zonder serviceovereenkomst en worden niet aanbevolen voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Supplemental Terms of Use for Microsoft Azure Previews (Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews) voor meer informatie.

Vereisten

  • Een Azure-abonnement. Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.
  • Een Machine Learning-werkruimte. Zie Werkruimteresources maken.
  • Uw gebruikersidentiteit moet toegang hebben tot het standaardopslagaccount van uw werkruimte. Of u notitieblokken kunt lezen, bewerken of maken, is afhankelijk van uw toegangsniveau tot uw werkruimte. Een inzender kan bijvoorbeeld het notitieblok bewerken, terwijl een lezer het alleen kan bekijken.

Toegang tot notitieblokken vanuit uw werkruimte

Gebruik de sectie Notebooks van uw werkruimte om Jupyter-notebooks te bewerken en uit te voeren.

  1. Aanmelden bij Azure Machine Learning-studio
  2. Selecteer uw werkruimte als deze nog niet is geopend
  3. Selecteer aan de linkerkant Notitieblokken

Een notitieblok bewerken

Als u een notitieblok wilt bewerken, opent u een notitieblok in de sectie Gebruikersbestanden van uw werkruimte. Klik op de cel die u wilt bewerken. Als u geen notitieblokken in deze sectie hebt, raadpleegt u Bestanden maken en beheren in uw werkruimte.

U kunt het notebook bewerken zonder verbinding te maken met een rekenproces. Wanneer u de cellen in het notebook wilt uitvoeren, selecteert of maakt u een rekenproces. Als u een gestopt rekenproces selecteert, wordt deze automatisch gestart wanneer u de eerste cel uitvoert.

Wanneer een rekenproces wordt uitgevoerd, kunt u ook codevoltooiing, mogelijk gemaakt door IntelliSense, gebruiken in elk Python-notebook.

U kunt Jupyter of JupyterLab ook starten vanaf de werkbalk van het notitieblok. Azure Machine Learning biedt geen updates en lost fouten van Jupyter of JupyterLab niet op, omdat het opensource-producten zijn die buiten de grenzen van Microsoft Ondersteuning vallen.

Focusmodus

Gebruik de focusmodus om uw huidige weergave uit te breiden, zodat u zich kunt richten op uw actieve tabbladen. In de focusmodus wordt de bestandenverkenner van Notebooks verborgen.

  1. Selecteer focusmodus in de werkbalk van het terminalvenster om de focusmodus in te schakelen. Afhankelijk van de breedte van het venster, bevindt het hulpmiddel zich mogelijk onder het menu-item ... op de werkbalk.

  2. Ga in de focusmodus terug naar de standaardweergave door Standaardweergave te selecteren.

    Focusmodus/standaardweergave in-/uitschakelen

Code-voltooiing (IntelliSense)

IntelliSense is een hulpmiddel voor het aanvullen van code dat veel functies bevat: Lijstleden, Parameter info, Snelle informatie en Complete Word. Met slechts enkele toetsaanslagen kunt u het volgende doen:

  • Meer informatie over de code die u gebruikt
  • Houd de parameters bij die u typt
  • Aanroepen toevoegen aan eigenschappen en methoden

Een notebook delen

Uw notitieblokken worden opgeslagen in het opslagaccount van uw werkruimte en kunnen worden gedeeld met anderen, afhankelijk van hun toegangsniveau tot uw werkruimte. Ze kunnen het notitieblok openen en bewerken zolang ze de juiste toegang hebben. Een inzender kan bijvoorbeeld het notitieblok bewerken, terwijl een lezer het alleen kan bekijken.

Andere gebruikers van uw werkruimte kunnen uw notebook vinden in de sectie Notebooks, Gebruikersbestanden van Azure ML Studio. Uw notitieblokken bevinden zich standaard in een map met uw gebruikersnaam en anderen hebben er toegang toe.

U kunt de URL ook vanuit uw browser kopiëren wanneer u een notitieblok opent en vervolgens naar anderen verzenden. Zolang ze de juiste toegang tot uw werkruimte hebben, kunnen ze het notitieblok openen.

Omdat u geen rekeninstanties deelt, doen andere gebruikers die uw notebook uitvoeren dit op hun eigen rekenproces.

Samenwerken met notitieblokopmerkingen (preview)

Gebruik een notitieblokcommentaritie om samen te werken met anderen die toegang hebben tot uw notitieblok.

Schakel het opmerkingenvenster in of uit met het notitieblok boven aan het notitieblok. Als uw scherm niet breed genoeg is, zoekt u dit hulpprogramma door eerst de ... aan het einde van de set hulpprogramma's te selecteren.

Schermopname van het notitieblok met opmerkingen op de bovenste werkbalk.

Of het opmerkingenvenster nu zichtbaar is of niet, u kunt een opmerking toevoegen aan elke codecel:

  1. Selecteer tekst in de codecel. U kunt alleen commentaar geven op tekst in een codecel.
  2. Gebruik het hulpprogramma Nieuwe opmerkingthread om uw opmerking te maken. Schermopname van het toevoegen van een opmerking aan een hulpprogramma voor een codecel.
  3. Als het opmerkingenvenster eerder verborgen was, wordt het nu geopend.
  4. Typ uw opmerking en plaats deze met het hulpprogramma of gebruik Ctrl+Enter.
  5. Zodra een opmerking is geplaatst, selecteert u ... in de rechterbovenhoek om:
    • De opmerking bewerken
    • De thread oplossen
    • De thread verwijderen

Tekst die is becommentarieerd, wordt weergegeven met een paarse markering in de code. Wanneer u een opmerking selecteert in het opmerkingenvenster, schuift uw notitieblok naar de cel met de gemarkeerde tekst.

Notitie

Opmerkingen worden opgeslagen in de metagegevens van de codecel.

Uw notitieblok opschonen (preview)

Tijdens het maken van een notebook krijgt u meestal cellen die u hebt gebruikt voor gegevensverkenning of foutopsporing. Met de functie verzamelen kunt u een schoon notitieblok maken zonder deze overbodige cellen.

  1. Voer alle notebookcellen uit.
  2. Selecteer de cel met de code die u het nieuwe notitieblok wilt uitvoeren. Bijvoorbeeld de code waarmee een experiment wordt verzonden of misschien de code waarmee een model wordt geregistreerd.
  3. Selecteer het pictogram Verzamelen dat wordt weergegeven op de celwerkbalk. Schermopname: selecteer het pictogram Verzamelen
  4. Voer de naam in voor het nieuwe 'verzamelde' notitieblok.

Het nieuwe notitieblok bevat alleen codecellen, waarbij alle cellen dezelfde resultaten moeten produceren als de cel die u hebt geselecteerd voor het verzamelen.

Een notitieblok opslaan en controleren

Azure Machine Learning maakt een controlepuntbestand wanneer u een ipynb-bestand maakt.

Selecteer in de werkbalk van het notitieblok het menu en selecteer vervolgens Bestand>Opslaan en controlepunt om het notitieblok handmatig op te slaan. Er wordt een controlepuntbestand toegevoegd dat aan het notitieblok is gekoppeld.

Schermafbeelding van het hulpprogramma voor opslaan op de werkbalk van het notitieblok

Elk notitieblok wordt elke 30 seconden automatisch opgeslagen. Automatisch opslaan werkt alleen het oorspronkelijke ipynb-bestand bij, niet het controlepuntbestand.

Selecteer Controlepunten in het notitieblokmenu om een benoemd controlepunt te maken en om het notitieblok terug te zetten naar een opgeslagen controlepunt.

Een notitieblok exporteren

Selecteer in de werkbalk van het notitieblok het menu en vervolgens Exporteren als om het notitieblok te exporteren als een van de ondersteunde typen:

  • Notebook
  • Python
  • HTML
  • Latex

Een notitieblok exporteren naar uw computer

Het geëxporteerde bestand wordt op uw computer opgeslagen.

Een notebook of Python-script uitvoeren

Als u een notebook of een Python-script wilt uitvoeren, maakt u eerst verbinding met een actief rekenproces.

  • Als u geen rekenproces hebt, gebruikt u deze stappen om er een te maken:

    1. Selecteer in de notebook- of scriptwerkbalk rechts van de vervolgkeuzelijst Compute de optie + Nieuwe berekening. Afhankelijk van uw schermgrootte kan dit zich onder een ... menu bevinden. Een nieuwe berekening maken
    2. Geef de naam Compute en kies de grootte van de virtuele machine.
    3. Selecteer Maken.
    4. Het rekenproces wordt automatisch verbonden met het bestand. U kunt nu de notebookcellen of het Python-script uitvoeren met behulp van het hulpprogramma links van het rekenproces.
  • Als u een gestopt rekenproces hebt, selecteert u Berekening starten rechts in de vervolgkeuzelijst Compute. Afhankelijk van uw schermgrootte kan dit zich onder een ... menu bevinden.

    Rekenproces starten

Zodra u verbinding hebt gemaakt met een rekenproces, gebruikt u de werkbalk om alle cellen in het notebook uit te voeren of gebruikt u Control + Enter om één geselecteerde cel uit te voeren.

Alleen u kunt de rekeninstanties zien en gebruiken die u maakt. Uw gebruikersbestanden worden afzonderlijk van de VIRTUELE machine opgeslagen en worden gedeeld tussen alle rekenprocessen in de werkruimte.

Logboeken en uitvoer weergeven

Gebruik notebookwidgets om de voortgang van de uitvoering en logboeken weer te geven. Een widget is asynchroon en biedt updates totdat de training is voltooid. Azure Machine Learning-widgets worden ook ondersteund in Jupyter en JupterLab.

Schermopname: Jupyter-notebookwidget

Variabelen in het notebook verkennen

Gebruik op de werkbalk van het notitieblok het hulpprogramma Variabeleverkenner om de naam, het type, de lengte en de voorbeeldwaarden weer te geven voor alle variabelen die in uw notebook zijn gemaakt.

Schermopname: Variabele verkenner

Selecteer het hulpprogramma om het venster variabeleverkenner weer te geven.

Schermopname: venster Variabeleverkenner

Gebruik op de werkbalk van het notitieblok het hulpmiddel Inhoudsopgave om de inhoudsopgave weer te geven of te verbergen. Start een Markdown-cel met een kop om deze toe te voegen aan de inhoudsopgave. Klik op een vermelding in de tabel om naar die cel in het notitieblok te schuiven.

Schermafbeelding: Inhoudsopgave in het notitieblok

De notebookomgeving wijzigen

Met de werkbalk van het notitieblok kunt u de omgeving wijzigen waarin uw notebook wordt uitgevoerd.

Met deze acties wordt de status van het notebook of de waarden van variabelen in het notebook niet gewijzigd:

Bewerking Resultaat
De kernel stoppen Stopt elke actieve cel. Als u een cel uitvoert, wordt de kernel automatisch opnieuw opgestart.
Navigeer naar een andere werkruimtesectie Actieve cellen worden gestopt.

Met deze acties wordt de notebookstatus opnieuw ingesteld en worden alle variabelen in het notebook opnieuw ingesteld.

Bewerking Resultaat
De kernel wijzigen Notebook maakt gebruik van nieuwe kernel
Schakelen tussen berekeningen Notebook maakt automatisch gebruik van de nieuwe berekening.
Rekenproces opnieuw instellen Wordt opnieuw gestart wanneer u een cel probeert uit te voeren
Rekenproces stoppen Er worden geen cellen uitgevoerd
Notitieblok openen in Jupyter of JupyterLab Notitieblok geopend op een nieuw tabblad.

Nieuwe kernels toevoegen

Gebruik de terminal om nieuwe kernels te maken en toe te voegen aan uw rekenproces. In het notebook worden automatisch alle Jupyter-kernels gevonden die op het verbonden rekenproces zijn geïnstalleerd.

Gebruik de vervolgkeuzelijst kernel aan de rechterkant om over te schakelen naar een van de geïnstalleerde kernels.

Pakketten beheren

Omdat uw rekenproces meerdere kernels heeft, moet u ervoor zorgen dat u %pipmagic-functies gebruikt%conda, waarmee pakketten worden geïnstalleerd in de kernel die momenteel wordt uitgevoerd. Gebruik !pip niet of !conda. Dit verwijst naar alle pakketten (inclusief pakketten buiten de kernel die momenteel wordt uitgevoerd).

Statusindicatoren

Een indicator naast de vervolgkeuzelijst Compute geeft de status aan. De status wordt ook weergegeven in de vervolgkeuzelijst zelf.

Kleur Rekenstatus
Green Rekenproces wordt uitgevoerd
Red Berekening is mislukt
Zwart Compute gestopt
Lichtblauw Compute maken, starten, opnieuw opstarten, instellen
Grijs Rekenproces verwijderen, stoppen

Een indicator naast de vervolgkeuzelijst Kernel geeft de status aan.

Kleur Kernel-status
Green Kernel verbonden, niet-actief, bezet
Grijs Kernel is niet verbonden

Rekengegevens zoeken

Meer informatie over uw rekeninstanties vindt u op de pagina Compute in Studio.

Handige sneltoetsen

Net als bij Jupyter Notebooks hebben Azure Machine Learning-studio notebooks een modale gebruikersinterface. Het toetsenbord doet verschillende dingen, afhankelijk van de modus waarin de notebookcel zich bevindt. Azure Machine Learning-studio notebooks ondersteunen de volgende twee modi voor een bepaalde codecel: opdrachtmodus en bewerkingsmodus.

Sneltoetsen voor de opdrachtmodus

Een cel bevindt zich in de opdrachtmodus wanneer er geen tekstcursor is die u vraagt om te typen. Wanneer een cel zich in de opdrachtmodus bevindt, kunt u het notitieblok als geheel bewerken, maar niet in afzonderlijke cellen typen. Ga naar de opdrachtmodus door te drukken ESC of met de muis te selecteren buiten het editorgebied van een cel. De linkerrand van de actieve cel is blauw en effen en de knop Uitvoeren is blauw.

Notebook-cel in opdrachtmodus

Snelkoppeling Description
Enter De modus Bewerken openen
Shift+Enter Cel uitvoeren, selecteer hieronder
Control/Command + Enter Cel uitvoeren
Alt + Enter Cel uitvoeren, codecel eronder invoegen
Control/Command + Alt + Enter Cel uitvoeren, eronder markdown-cel invoegen
Alt + R Alles uitvoeren
J Cel converteren naar code
M Cel converteren naar markdown
Omhoog/K Cel erboven selecteren
Omlaag/J Selecteer de cel eronder
A Codecel boven invoegen
B Codecel onder invoegen
Control/Command + Shift + A Markdown-cel boven invoegen
Control/Command + Shift + B Markdown-cel onder invoegen
X Geselecteerde cel knippen
C Geselecteerde cel kopiëren
Shift + V Geselecteerde cel boven plakken
V Geselecteerde cel onder plakken
D D Geselecteerde cel verwijderen
O Uitvoer in-/uitschakelen
Shift + O Bladeren met uitvoer in-/uitschakelen
I I Kernel onderbreken
0 0 Kernel opnieuw opstarten
Shift + spatiebalk Omhoog schuiven
Space Omlaag schuiven
Tabblad De focus wijzigen in het volgende focusbare item (wanneer de tab-trap is uitgeschakeld)
Control/Command + S Notitieblok opslaan
1 Wijzigen in h1
2 Wijzigen in h2
3 Wijzigen in h3
4 Wijzigen in h4
5 Wijzigen in h5
6 Wijzigen in h6

Snelkoppelingen in de bewerkingsmodus

De bewerkingsmodus wordt aangegeven door een tekstcursor die u vraagt om te typen in het editorgebied. Wanneer een cel zich in de bewerkingsmodus bevindt, kunt u in de cel typen. Bewerk de bewerkingsmodus door met de muis te drukken Enter of te selecteren in het editorgebied van een cel. De linkerrand van de actieve cel is groen en uitgebroed en de knop Uitvoeren is groen. U ziet ook de cursorprompt in de cel in de bewerkingsmodus.

Notitieblokcel in bewerkingsmodus

Met behulp van de volgende toetsaanslagsneltoetsen kunt u eenvoudiger navigeren en code uitvoeren in Azure Machine Learning-notebooks in de bewerkingsmodus.

Snelkoppeling Description
Escape Opdrachtmodus activeren
Control/Command + spatiebalk IntelliSense activeren
Shift+Enter Cel uitvoeren, selecteer hieronder
Control/Command + Enter Cel uitvoeren
Alt + Enter Cel uitvoeren, codecel eronder invoegen
Control/Command + Alt + Enter Cel uitvoeren, eronder markdown-cel invoegen
Alt + R Alle cellen uitvoeren
Omhoog Cursor omhoog of vorige cel verplaatsen
Buiten gebruik Cursor omlaag of volgende cel verplaatsen
Control/Command + S Notitieblok opslaan
Control/Command + Omhoog Naar het begin van de cel gaan
Control/Command + Omlaag Naar het einde van de cel gaan
Tabblad Code aanvullen of inspringen (als tabtrap is ingeschakeld)
Control/Command + M Tab-trap in-/uitschakelen
Control/Command + ] Streepje
Control/Command + [ Dedent
Control/Command + A Alles selecteren
Control/Command + Z Ongedaan maken
Control/Command + Shift + Z Opnieuw uitvoeren
Control/Command + Y Opnieuw uitvoeren
Control/Command + Home Naar het begin van de cel gaan
Control/Command + End Naar het einde van de cel gaan
Control/Command + links Eén woord naar links gaan
Control/Command + rechts Eén woord naar rechts gaan
Control/Command + Backspace Woord vóór verwijderen
Control/Command + Delete Woord na verwijderen
Control/Command + / Opmerking in cel in-/uitschakelen

Problemen oplossen

  • Verbinding maken met een notebook: als u geen verbinding kunt maken met een notebook, moet u ervoor zorgen dat websocketscommunicatie niet is uitgeschakeld. De Jupyter-functionaliteit van het rekenproces werkt alleen als websocket-communicatie is ingeschakeld. Zorg ervoor dat uw netwerk websocket-verbindingen met *.instances.azureml.net en *.instances.azureml.ms toestaat.

  • Privé-eindpunt: wanneer een rekenproces wordt geïmplementeerd in een werkruimte met een privé-eindpunt, kan het alleen worden geopend vanuit een virtueel netwerk. Als u een aangepast DNS- of hosts-bestand gebruikt, voegt u een vermelding toe voor < exemplaarnaam >.< regio >.instances.azureml.ms met het privé-IP-adres van het privé-eindpunt van uw werkruimte. Zie het aangepaste DNS-artikel voor meer informatie.

  • Kernelcrash: als uw kernel is gecrasht en opnieuw is opgestart, kunt u de volgende opdracht uitvoeren om het jupyter-logboek te bekijken en meer informatie te vinden: sudo journalctl -u jupyter. Als kernelproblemen zich blijven voordoen, kunt u overwegen een rekenproces met meer geheugen te gebruiken.

  • Kernel niet gevonden of kernelbewerkingen zijn uitgeschakeld: wanneer u de standaardkernel van Python 3.8 op een rekenproces gebruikt, krijgt u mogelijk een fout zoals 'Kernel niet gevonden' of 'Kernelbewerkingen zijn uitgeschakeld'. Gebruik een van de volgende methoden om dit op te lossen:

    • Maak een nieuw rekenproces. Er wordt een nieuwe installatiekopieën gebruikt waarin dit probleem is opgelost.
    • Gebruik de Py 3.6-kernel op het bestaande rekenproces.
    • Voer OR uit pip install ipykernel==6.6.0 vanuit een terminal in de standaard py38-omgeving pip install ipykernel==6.0.3
  • Verlopen token: als er een probleem met een verlopen token optreedt, meldt u zich af bij uw Azure ML-studio, meldt u zich weer aan en start u de notebook-kernel opnieuw.

  • Limiet voor het uploaden van bestanden: wanneer u een bestand uploadt via de Bestandenverkenner van het notitieblok, hebt u een beperkt aantal bestanden die kleiner zijn dan 5 TB. Als u een bestand wilt uploaden dat groter is dan dit, raden we u aan de SDK te gebruiken om de gegevens te uploaden naar een gegevensarchief. Zie Gegevensassets maken voor meer informatie.

Volgende stappen