Exécuter des notebooks Jupyter dans votre espace de travail

Découvrez comment exécuter vos Jupyter notebooks Jupyter directement dans votre espace de travail dans Azure Machine Learning studio. En plus de la possibilité de lancer Jupyter ou JupyterLab, vous pouvez modifier et exécuter vos blocs-notes sans quitter l’espace de travail.

Pour plus d’informations sur la création et la gestion de fichiers, y compris de notebooks, consultez Créer et gérer des fichiers dans votre espace de travail.

Important

Les fonctionnalités marquées (préversion) étant fournies sans contrat de niveau de service, elles sont déconseillées pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.

Prérequis

Exécuter un bloc-notes

Pour modifier un bloc-notes, ouvrez n’importe quel bloc-notes situé dans la section Fichiers utilisateur de votre espace de travail. Cliquez sur la cellule à modifier. Si vous n’avez pas de notebooks dans cette section, consultez Créer et gérer des fichiers dans votre espace de travail.

Vous pouvez modifier le bloc-notes sans vous connecter à une instance de calcul. Lorsque vous souhaitez exécuter les cellules du bloc-notes, sélectionnez ou créez une instance de calcul. Si vous sélectionnez une instance de calcul arrêtée, elle démarre automatiquement lorsque vous exécutez la première cellule.

Quand une instance de calcul est en cours d’exécution, vous pouvez également utiliser la saisie semi-automatique du code, optimisée par IntelliSense, dans n’importe quel notebook Python.

Vous pouvez également lancer Jupyter ou JupyterLab à partir de la barre d’outils du notebook. Azure Machine Learning ne fournit pas de mises à jour et ne corrige pas les bogues de Jupyter ou JupyterLab, car il s’agit de produits open source qui sortent des limites du Support Microsoft.

Mode focus

Utilisez le mode focus pour développer votre affichage actuel afin de pouvoir vous concentrer sur vos onglets actifs. Le mode focus masque l’explorateur de fichiers Notebooks.

  1. Dans la barre d’outils de la fenêtre du terminal, sélectionnez Mode focus pour activer le mode focus. Selon la largeur de votre fenêtre, l’outil peut se trouver sous l’élément de menu dans la barre d’outils.

  2. En mode focus, revenez à l’affichage standard en sélectionnant Affichage standard.

    Toggle focus mode / standard view

Saisie semi-automatique du code (IntelliSense)

IntelliSense est une aide à la saisie semi-automatique de code, qui inclut de nombreuses fonctionnalités : Liste des membres, Informations sur les paramètres, Informations rapides et Compléter le mot. L’action de quelques touches suffit pour :

  • En savoir plus sur le code que vous utilisez
  • Suivre les paramètres que vous tapez
  • Ajouter des appels aux propriétés et aux méthodes

Insérer des extraits de code (préversion)

Utilisez Ctrl + Espace pour déclencher les extraits de code IntelliSense. Faites défiler les suggestions ou commencez à taper pour rechercher le code à insérer. Une fois que vous avez inséré du code, déplacez-vous dans les arguments afin de personnaliser le code pour votre propre usage.

Insert a code snippet

Ces mêmes extraits de code sont disponibles lorsque vous ouvrez votre notebook dans VS Code. Pour obtenir la liste complète des extraits de code disponibles, consultez Extraits de code VS de Azure Machine Learning.

Vous pouvez parcourir liste et y rechercher des extraits de code à l’aide de la barre d’outils du notebook pour ouvrir le panneau d’extrait de code.

Open snippet panel tool in the notebook toolbar

À partir du panneau des extraits de code, vous pouvez également envoyer une demande d’ajout d’extrait de code.

Snippet panel allows you to propose a new snippet

Partager un notebook

Vos notebooks sont stockés dans le compte de stockage de votre espace de travail, et peuvent être partagés avec d’autres utilisateurs, en fonction de leur niveau d’accès à votre espace de travail. Ceux-ci peuvent ouvrir et modifier les notebooks tant qu’ils disposent de l’accès approprié. Par exemple, un contributeur peut modifier le notebook, tandis qu’un lecteur ne peut l’afficher qu’une seule fois.

D’autres utilisateurs de votre espace de travail peuvent trouver votre notebook dans la section Notebooks, Fichiers utilisateur d’Azure ML studio. Par défaut, vos notebooks se trouvent dans un dossier avec votre nom d’utilisateur. D’autres utilisateurs peuvent y accéder.

Vous pouvez également copier l’URL à partir de votre navigateur lorsque vous ouvrez un notebook, puis l’envoyer à d’autres utilisateurs. Tant qu’ils disposent d’un accès approprié à votre espace de travail, ceux-ci peuvent ouvrir le notebook.

Étant donné que vous ne partagez pas d’instance de calcul, les autres utilisateurs qui exécutent votre notebook le font sur leur propre instance de calcul.

Collaborer avec des commentaires de notebook (préversion)

Utilisez un commentaire de notebook pour collaborer avec d’autres personnes qui ont accès à votre notebook.

Activez ou désactivez le volet des commentaires avec l’outil Commentaires de notebook en haut du notebook. Si votre écran n’est pas assez large, recherchez cet outil en sélectionnant d’abord ... à la fin de l’ensemble d’outils.

Screenshot of notebook comments tool in the top toolbar.

Que le volet des commentaires soit visible ou non, vous pouvez ajouter un commentaire dans n’importe quelle cellule de code :

  1. Sélectionnez du texte dans la cellule de code. Vous pouvez uniquement commenter le texte dans une cellule de code.
  2. Utilisez l’outil Nouveau thread de commentaires pour créer votre commentaire. Screenshot of add a comment to a code cell tool.
  3. Si le volet des commentaires était masqué, il s’ouvre.
  4. Tapez votre commentaire et publiez-le avec l’outil ou utilisez Ctrl + Entrée.
  5. Une fois qu’un commentaire a été publié, sélectionnez ... en haut à droite pour :
    • Modifier le commentaire
    • Résoudre le thread
    • Supprimer le thread

Le texte qui a été commenté apparaît avec une mise en surbrillance violette dans le code. Quand vous sélectionnez un commentaire dans le volet des commentaires, votre notebook défile jusqu’à la cellule qui contient le texte mis en surbrillance.

Notes

Les commentaires sont enregistrés dans les métadonnées de la cellule de code.

Nettoyer votre notebook (préversion)

Au cours de la création d’un notebook, vous récupérez généralement les cellules que vous avez utilisées pour l’exploration des données ou le débogage. La fonctionnalité Gather (Assembler) vous permet de créer un notebook propre sans ces cellules superflues.

  1. Exécutez toutes les cellules de votre notebook.
  2. Sélectionnez la cellule qui contient le code que vous souhaitez que le nouveau notebook exécute. Par exemple, le code qui soumet une expérience ou le code qui inscrit un modèle.
  3. Sélectionnez l’icône Gather (Assembler) qui apparaît dans la barre d’outils de la cellule. Screenshot: select the Gather icon
  4. Entrez le nom de votre nouveau notebook « assemblé ».

Le nouveau notebook contient uniquement des cellules de code, ainsi que toutes les cellules requises pour produire les mêmes résultats que ceux obtenus dans la cellule que vous avez sélectionnée pour l’assemblage.

Enregistrement et point de contrôle d’un bloc-notes

Azure Machine Learning crée un fichier de point de contrôle lorsque vous créez un fichier ipynb.

Dans la barre d’outils du bloc-notes, sélectionnez le menu, puis FichierEnregistrer et effectuer un point de contrôle pour enregistrer manuellement le bloc-notes et ajouter un fichier de point de contrôle associé au bloc-notes.

Screenshot of save tool in notebook toolbar

Chaque bloc-notes est enregistré de façon automatique toutes les 30 secondes. L’enregistrement automatique met à jour uniquement le fichier ipynb initial, pas le fichier de point de contrôle.

Sélectionnez Points de contrôle dans le menu du bloc-notes pour créer un point de contrôle nommé et restaurer le bloc-notes à un point de contrôle enregistré.

Exporter un notebook

Dans la barre d’outils du notebook, sélectionnez le menu, puis Exporter en tant que pour exporter le notebook en tant qu’un des types pris en charge :

  • Notebook
  • Python
  • HTML
  • LaTeX

Export a notebook to your computer

Le fichier exporté est enregistré sur votre ordinateur.

Exécuter un notebook ou un script Python

Pour exécuter un notebook ou un script Python, vous devez d’abord vous connecter à une instance de calcul en cours d’exécution.

  • Si vous n’avez pas d’instance de calcul, procédez comme suit pour en créer une :

    1. Dans la barre d’outils du notebook ou du script, à droite de la liste déroulante Calcul, sélectionnez + Nouveau calcul. Selon la taille de votre écran, cette option peut se trouver dans un menu ... . Create a new compute
    2. Nommez l’instance de calcul, puis choisissez une taille de machine virtuelle.
    3. Sélectionnez Create (Créer).
    4. L’instance de calcul est connectée automatiquement au fichier. Vous pouvez maintenant exécuter les cellules du notebook ou du script Python à l’aide de l’outil situé à gauche de l’instance de calcul.
  • Si vous avez une instance de calcul arrêtée, sélectionnez Démarrer le calcul à droite de la liste déroulante Calcul. Selon la taille de votre écran, cette option peut se trouver dans un menu ... .

    Start compute instance

Une fois que vous êtes connecté à une instance de calcul, utilisez la barre d’outils pour exécuter toutes les cellules du notebook ou Ctrl + Entrée pour exécuter une seule cellule sélectionnée.

Vous seul pouvez voir et utiliser les instances de calcul que vous créez. Vos Fichiers utilisateur sont stockés séparément de la machine virtuelle, et partagés entre toutes les instances de calcul dans l’espace de travail.

Afficher les journaux et la sortie

Utilisez des widgets de notebook pour afficher la progression de l’exécution et les journaux. Un widget est asynchrone et fournit des mises à jour jusqu’à ce que l’apprentissage se termine. Les widgets d’Azure Machine Learning sont également pris en charge dans Jupyter et JupterLab.

Screenshot: Jupyter notebook widget

Explorer les variables dans le notebook

Dans la barre d’outils du notebook, utilisez l’outil Explorateur de variables pour afficher le nom, le type, la longueur et les exemples de valeurs pour toutes les variables qui ont été créées dans votre notebook.

Screenshot: Variable explorer tool

Sélectionnez l’outil pour afficher la fenêtre de l’Explorateur de variables.

Screenshot: Variable explorer window

Dans la barre d’outils du notebook, utilisez l’outil Table des matières pour afficher ou masquer la table des matières. Démarrez une cellule Markdown avec un titre pour l’ajouter à la table des matières. Cliquez sur une entrée de la table pour atteindre cette cellule dans le notebook.

Screenshot: Table of contents in the notebook

Modifier l’environnement du bloc-notes

La barre d’outils du notebook vous permet de modifier l’environnement d’exécution de votre notebook.

Ces actions ne modifient pas l’état du bloc-notes ou les valeurs des variables dans celui-ci :

Action Résultats
Arrêter le noyau Arrête toute cellule en cours d’exécution. L’exécution d’une cellule entraîne automatiquement le redémarrage du noyau.
Naviguer vers une autre section de l’espace de travail Les cellules en cours d’exécution sont arrêtées.

Les actions ci-après ont pour effet de réinitialiser l’état du bloc-notes et toutes les variables dans celui-ci.

Action Résultats
Modifier le noyau Le bloc-notes utilise le nouveau noyau.
Changer d’instance de calcul Le bloc-notes utilise automatiquement la nouvelle instance de calcul.
Réinitialiser l’instance de calcul Redémarre quand vous tentez d’exécuter une cellule.
Arrêter l’instance de calcul Aucune cellule ne s’exécute.
Ouvrir le bloc-notes dans Jupyter ou JupyterLab Le bloc-notes s’ouvre dans un nouvel onglet.

Ajouter de nouveaux noyaux

Utilisez le terminal pour créer des noyaux et les ajouter à votre instance de calcul. Le notebook trouve automatiquement tous les noyaux Jupyter installés sur l’instance de calcul connectée.

Utilisez la liste déroulante des noyaux à droite pour passer à l’un des noyaux installés.

Gérer les packages

Dans la mesure où votre instance de calcul a plusieurs noyaux, veillez à utiliser %pip ou des %condafonctions magiques qui installent les packages dans le noyau en cours d’exécution. N’utilisez pas !pip ou !conda qui fait référence à tous les packages (y compris les packages en dehors du noyau en cours d’exécution).

Indicateurs d’état

Un indicateur en regard de la liste déroulante Calcul affiche son état. L’État est également indiqué dans la liste déroulante elle-même.

Couleur État du calcul
Vert Calcul en cours d’exécution
Rouge Échec du calcul
Noir Calcul arrêté
Bleu clair Calcul en cours de création, de démarrage, de redémarrage ou de configuration
Gris Calcul en cours d’arrêt ou de suppression

Un indicateur en regard de la liste déroulante Noyau affiche son état.

Couleur État du noyau
Vert Noyau connecté, inactif, occupé
Gris Tunnel non connecté.

Rechercher les détails d’un calcul

Pour plus de détails sur vos instances de calcul, consultez la page Calcul dans de Studio.

Raccourcis clavier utiles

À l’instar des notebooks Jupyter, les notebooks Azure Machine Learning Studio disposent d’une interface utilisateur modale. Le clavier effectue des actions différentes selon le mode dans lequel se trouve la cellule du bloc-notes. Les notebooks Azure Machine Learning Studio prennent en charge les deux modes suivants pour une cellule de code donnée : le mode de commande et le mode d’édition.

Raccourcis du mode de commande

Une cellule est en mode de commande quand elle n’affiche aucun curseur texte vous invitant à saisir. Quand une cellule est en mode de commande, vous pouvez modifier le bloc-notes entier, mais pas taper dans des cellules individuelles. Entrez en mode de commande en appuyant sur ESC ou en utilisant la souris pour sélectionner en dehors de la zone de l’éditeur d’une cellule. La bordure gauche de la cellule active est bleue et unie, et son bouton Exécuter est bleu.

Notebook cell in command mode

Raccourci Description
Entrez Passer au mode Édition
Maj+Entrée Exécuter la cellule, sélectionner en dessous
Contrôle/Commande + Entrée Exécuter la cellule
Alt + Entrée Exécuter la cellule, insérer la cellule de code en dessous
Contrôle/Commande + Alt + Entrée Exécuter la cellule, insérer la cellule Markdown en dessous
Alt + R Exécuter tout
O Convertir la cellule en code
M Convertir la cellule en Markdown
Haut/K Sélectionner la cellule au-dessus
Bas/J Sélectionner la cellule en dessous
Un Insérer une cellule de code au-dessus
B Insérer une cellule de code au-dessous
Contrôle/Commande + Maj + A Insérer une cellule Markdown au-dessus
Contrôle/Commande + Maj + B Insérer une cellule Markdown au-dessous
X Couper la cellule sélectionnée
C Copier la cellule sélectionnée
Maj + V Coller la cellule sélectionnée au-dessus
V Coller la cellule sélectionnée au-dessous
D D Supprimer la cellule sélectionnée
O Activer/désactiver la sortie
Maj + O Activer/désactiver le défilement de sortie
I I Interrompre le noyau
0 0 Redémarrer le noyau
Maj + espace Faire défiler vers le haut
Espace Faire défiler vers le bas
Onglet Définir le focus sur le prochain élément pouvant être actif (quant le recouvrement par tabulation est désactivé)
Contrôle/Commande + S Enregistrer le notebook
1 Remplacer par h1
2 Remplacer par h2
3 Remplacer par h3
4 Remplacer par h4
5 Remplacer par h5
6 Remplacer par h6

Raccourcis du mode d’édition

Le mode d’édition est indiqué par un curseur texte qui vous invite à taper dans la zone de l’éditeur. Quand une cellule est en mode d’édition, vous pouvez saisir dans la cellule. Entrez en mode édition en appuyant sur Enter ou en utilisant la souris pour sélectionner la zone de l’éditeur d’une cellule. La bordure gauche de la cellule active est verte et en pointillés, et son bouton Exécuter est vert. Vous voyez également l’invite de curseur dans la cellule en mode d’édition.

Notebook cell in edit mode

Les raccourcis clavier suivants vous permettent de naviguer et d’exécuter du code plus facilement dans des notebooks Azure Machine Learning en mode d’édition.

Raccourci Description
Caractère d'échappement Entrer en mode de commande
Contrôle/Commande + espace Activer IntelliSense
Maj+Entrée Exécuter la cellule, sélectionner en dessous
Contrôle/Commande + Entrée Exécuter la cellule
Alt + Entrée Exécuter la cellule, insérer la cellule de code en dessous
Contrôle/Commande + Alt + Entrée Exécuter la cellule, insérer la cellule Markdown en dessous
Alt + R Exécuter toutes les cellules
Haut Déplacer le curseur vers le haut ou vers la cellule précédente
Descendre Déplacer le curseur vers le bas ou la cellule suivante
Contrôle/Commande + S Enregistrer le notebook
Contrôle/Commande + haut Atteindre le début de la cellule
Contrôle/Commande + bas Atteindre la fin de la cellule
Onglet Saisie semi-automatique de code ou mise en retrait (si le recouvrement par tabulation est activé)
Contrôle/Commande + M Activer/désactiver le recouvrement par tabulation
Contrôle/Commande + ] Retrait
Contrôle/Commande + [ Retrait négatif
Contrôle/Commande + A Sélectionner tout
Contrôle/Commande + Z Annuler
Contrôle/Commande + Maj + Z Rétablir
Contrôle/Commande + Y Rétablir
Contrôle/Commande + début Atteindre le début de la cellule
Contrôle/Commande + fin Atteindre la fin de la cellule
Contrôle/Commande + gauche Atteindre le mot à gauche
Contrôle/Commande + droite Atteindre le mot à droite
Contrôle/Commande + retour arrière Supprimer le mot précédent
Contrôle/Commande + Suppr Supprimer le mot suivant
Contrôle/Commande + / Afficher/masquer le commentaire sur la cellule

Dépannage

  • Si vous ne pouvez pas vous connecter à un notebook, vérifiez que la communication avec le socket web n’est pas désactivée. Pour que la fonctionnalité d’instance de calcul Jupyter fonctionne, la communication avec le socket web doit être activée. Vérifiez que votre réseau autorise les connexions WebSocket à *.instances.azureml.net et *.instances.azureml.ms.

  • Quand une instance de calcul est déployée dans un espace de travail avec un point de terminaison privé, elle est uniquement accessible à partir d’un réseau virtuel. Si vous utilisez un DNS ou un fichier hosts personnalisés, ajoutez une entrée pour < instance-name >.< region >.instances.azureml.ms avec l’adresse IP privée du point de terminaison privé de votre espace de travail. Pour plus d’informations, consultez l’article DNS personnalisé.

  • Si votre noyau a planté et a été redémarré, vous pouvez exécuter la commande suivante pour consulter le journal jupyter et obtenir plus de détails: sudo journalctl -u jupyter. Si les problèmes de noyau persistent, n’hésitez pas à utiliser une instance de calcul offrant davantage de mémoire.

  • Si vous rencontrez un problème de jeton expiré, déconnectez-vous du studio Azure Machine Learning, reconnectez-vous, puis redémarrez le noyau de notebook.

Étapes suivantes