Exécuter des notebooks Jupyter dans votre espace de travail

Cet article démontre comment exécuter vos notebooks Jupyter dans votre espace de travail dans Azure Machine Learning studio. Il existe également d’autres façons d’exécuter le notebook : Jupyter, JupyterLabet Visual Studio Code. VS Code Desktop peut être configuré pour accéder à votre instance de calcul. En alternative, utilisez VS Code pour le web, directement à partir du navigateur et sans installations ou dépendances requises.

Nous vous recommandons d’essayer VS Code pour le web pour tirer parti de l’intégration facile et de l’environnement de développement enrichi qu’il fournit. VS Code pour le web vous offre une grande partie de vos fonctionnalités VS Code Desktop favorites, notamment la recherche et la mise en surbrillance de la syntaxe lors de la navigation et de la modification. Pour plus d’informations sur l’utilisation de VS Code Desktop et VS Code pour le web, consultez Lancer Visual Studio Code intégré à Azure Machine Learning (préversion) et Travailler dans VS Code connecté à distance à une instance de calcul (préversion).

Quelle que soit la solution que vous utilisez pour exécuter le notebook, vous aurez accès à tous les fichiers de votre 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.

Dans un deuxième temps, cet article montre l’expérience d’exécution du notebook directement dans studio.

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

• Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
• Un espace de travail Machine Learning. Consultez Créer des ressources d’espace de travail.
• Votre identité d’utilisateur doit avoir accès au compte de stockage par défaut de votre espace de travail. Le fait de pouvoir lire, modifier ou créer des notebooks dépend de votre niveau d’accès à votre espace de travail. Par exemple, un contributeur peut modifier le notebook, tandis qu’un lecteur ne peut l’afficher qu’une seule fois.

Accéder aux notebooks à partir de votre espace de travail

Utilisez la section Notebooks de votre espace de travail pour modifier et exécuter des notebooks Jupyter.

1. Connectez-vous à Azure Machine Learning Studio
2. Sélectionnez votre espace de travail, s’il n’est pas déjà ouvert
3. Sur la gauche, sélectionnez Notebooks.

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. Sélectionnez la cellule que vous voulez 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 ce sont des produits open source qui ne relèvent pas 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.

   

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

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 Machine Learning 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.

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.
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.
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 Fichier>Enregistrer 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.

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

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 ... .
  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 ... .

  

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.

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.

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

Naviguer avec une table des matières

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. Sélectionnez une entrée de la table pour atteindre cette cellule dans le 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 changent 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 de Jupyter Notebooks, 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 commande quand elle n’y a pas de curseur de texte vous invitant à taper quelque chose. 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.

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 sélectionnant 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.

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

• Connexion à un notebook : si vous ne pouvez pas vous connecter à un notebook, vérifiez que la communication WebSocket 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.

• Point de terminaison privé : 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 d’hôtes personnalisé, ajoutez une entrée pour < nom-instance >.< région >.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é.

• Plantage du noyau : 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.

• Noyau introuvable ou Opérations du noyau désactivées : lorsque vous utilisez le noyau Python 3.8 par défaut sur une instance de calcul, vous pouvez rencontrer une erreur telle que « Noyau introuvable » ou « Les opérations du noyau ont été désactivées ». Pour la résoudre, appliquez l'une des méthodes suivantes :

  • Créez une instance de calcul. Cette opération utilise une nouvelle image dans laquelle ce problème a été résolu.
  • Utilisez le noyau Py 3.6 sur l’instance de calcul existante.
  • À partir d’un terminal dans l’environnement py38 par défaut, exécutez pip install ipykernel==6.6.0 OU pip install ipykernel==6.0.3

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

• Limite de chargement de fichier : quand vous chargez un fichier via l’explorateur de fichiers du notebook, vous êtes limité aux fichiers dont la taille est inférieure à 5 To. Si vous avez besoin de charger un fichier plus volumineux, nous vous recommandons d’utiliser le Kit de développement logiciel (SDK) pour charger les données dans un magasin de données. Pour plus d’informations, consultez Créer des ressources de données.

Étapes suivantes

• Exécuter votre première expérience
• Sauvegarder votre stockage de fichiers avec des captures instantanées
• Utilisation des environnements sécurisés