Comment exécuter des blocs-notes Jupyter dans votre espace de travailHow to run Jupyter Notebooks in your workspace

Découvrez comment exécuter vos blocs-notes Jupyter directement dans votre espace de travail dans Azure Machine Learning Studio.Learn how to run your Jupyter Notebooks directly in your workspace in 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.While you can launch Jupyter or JupyterLab, you can also edit and run your notebooks without leaving the workspace.

Découvrez comment effectuer les opérations suivantes :See how you can:

  • Créer des blocs-notes Jupyter dans votre espace de travailCreate Jupyter Notebooks in your workspace
  • Exécuter une expérience à partir d’un bloc-notesRun an experiment from a notebook
  • Modifier l’environnement du bloc-notesChange the notebook environment
  • Trouver des détails sur les instances de calcul utilisées pour exécuter vos blocs-notesFind details of the compute instances used to run your notebooks

PrérequisPrerequisites

Créer des blocs-notesCreate notebooks

Dans votre espace de travail Azure Machine Learning, créez un bloc-notes Jupyter, puis commencez à travailler.In your Azure Machine Learning workspace, create a new Jupyter notebook and start working. Le bloc-notes nouvellement créé est stocké dans le stockage de l’espace de travail par défaut.The newly created notebook is stored in the default workspace storage. Vous pouvez partager ce bloc-notes avec quiconque ayant accès à l’espace de travail.This notebook can be shared with anyone with access to the workspace.

Pour créer un bloc-notes :To create a new notebook:

  1. Dans Azure Machine Learning Studio, ouvrez votre espace de travail.Open your workspace in Azure Machine Learning studio.

  2. Sur le côté gauche, sélectionnez Bloc-notes.On the left side, select Notebooks.

  3. Sélectionnez l’icône Créer un fichier dans la section Mes fichiers au-dessus de la liste Fichiers utilisateur.Select the Create new file icon above the list User files in the My files section.

    Créer un fichier

  4. Nommez le fichier.Name the file.

  5. Pour Fichiers Jupyter Notebook, sélectionnez le type de fichier Bloc-note.For Jupyter Notebook Files, select Notebook as the file type.

  6. Sélectionnez un répertoire de fichiers.Select a file directory.

  7. Sélectionnez Create (Créer).Select Create.

Vous pouvez également créer des fichiers texte.You can create text files as well. Sélectionnez le type de fichier Texte , puis ajoutez l’extension au nom (par exemple, monfichier.py ou monfichier.txt).Select Text as the file type and add the extension to the name (for example, myfile.py or myfile.txt)

Vous pouvez également charger des dossiers et fichiers, dont des blocs-notes, avec les outils disponibles en haut de la page Blocs-notes.You can also upload folders and files, including notebooks, with the tools at the top of the Notebooks page. Les blocs-notes et la plupart des types de fichiers texte figurent dans la section d’aperçu.Notebooks and most text file types display in the preview section. Aucun aperçu n’est disponible pour la plupart des autres types de fichiers.No preview is available for most other file types.

Importante

Le contenu dans les blocs-notes et les scripts peut potentiellement lire les données de vos sessions et accéder aux données sans votre organisation dans Azure.Content in notebooks and scripts can potentially read data from your sessions and access data without your organization in Azure. Chargez uniquement des fichiers provenant de sources fiables.Only load files from trusted sources. Pour plus d’informations, consultez Meilleures pratiques pour un codage sûr.For more information, see Secure code best practices.

Cloner des exemplesClone samples

Votre espace de travail comprend un dossier Exemples contenant des blocs-notes conçus pour vous aider à explorer le Kit de développement logiciel (SDK) et servir d’exemples pour vos propres projets de Machine Learning.Your workspace contains a Samples folder with notebooks designed to help you explore the SDK and serve as examples for your own machine learning projects. Vous pouvez cloner ces blocs-notes vers votre propre dossier dans le conteneur de stockage de votre espace de travail.You can clone these notebooks into your own folder on your workspace storage container.

Pour obtenir un exemple, consultez Tutoriel : Créer votre première expérience ML.For an example, see Tutorial: Create your first ML experiment.

Utiliser des fichiers de Git et contrôler la version de mes fichiersUse files from Git and version my files

Vous pouvez accéder à toutes les opérations Git à l’aide d’une fenêtre de terminal.You can access all Git operations by using a terminal window. Tous les fichiers et dossiers Git sont stockés dans le système de fichiers de votre espace de travail.All Git files and folders will be stored in your workspace file system.

Nota

Ajoutez vos fichiers et dossiers n’importe où dans le dossier ~/cloudfiles/code/Users afin qu’ils soient visibles dans tous vos environnements Jupyter.Add your files and folders anywhere under the ~/cloudfiles/code/Users folder so they will be visible in all your Jupyter environments.

Pour accéder au terminal :To access the terminal:

  1. Dans Azure Machine Learning Studio, ouvrez votre espace de travail.Open your workspace in Azure Machine Learning studio.

  2. Sur le côté gauche, sélectionnez Bloc-notes.On the left side, select Notebooks.

  3. Sélectionnez un bloc-notes dans la section Fichiers utilisateur sur le côté gauche.Select any notebook located in the User files section on the left-hand side. Si aucun bloc-notes ne s’y trouve, commencez par créer un bloc-notes.If you don't have any notebooks there, first create a notebook

  4. Sélectionnez ou créez une cible de calcul , puis attendez qu’elle s’exécute.Select a Compute target or create a new one and wait until it's running.

  5. Sélectionnez l’icône Ouvrir le terminal.Select the Open terminal icon.

    Ouvrir le terminal

  6. Si vous ne voyez pas l’icône, sélectionnez les points de suspension ( ... ) à droite de la cible de calcul, puis choisissez Ouvrir le terminal.If you don't see the icon, select the ... to the right of the compute target and then select Open terminal.

    Ouvrir le terminal à partir de...

Apprenez-en davantage sur le clonage des dépôts Git dans le système de fichiers de votre espace de travail.Learn more about cloning Git repositories into your workspace file system.

Opérations Copier et Coller dans le terminalCopy and Paste in Terminal

  • Windows : Ctrl-Insert pour copier et Ctrl-Shift-v ou Shift-Insert pour coller.Windows: Ctrl-Insert to copy and use Ctrl-Shift-v or Shift-Insert to paste.
  • Mac OS : Cmd-c pour copier et Cmd-v pour coller.Mac OS: Cmd-c to copy and Cmd-v to paste.
  • FireFox/IE peuvent ne pas prendre en charge correctement les autorisations de Presse-papiers.FireFox/IE may not support clipboard permissions properly.

Partager des blocs-notes et d’autres fichiersShare notebooks and other files

Copiez et collez l’URL pour partager un bloc-notes ou un fichier.Copy and paste the URL to share a notebook or file. Seuls les autres utilisateurs de l’espace de travail peuvent accéder à cette URL.Only other users of the workspace can access this URL. Apprenez-en davantage sur l’octroi d’accès à votre espace de travail.Learn more about granting access to your workspace.

Exécuter un bloc-notesEdit a notebook

Pour modifier un bloc-notes, ouvrez n’importe quel bloc-notes situé dans la section Fichiers utilisateur de votre espace de travail.To edit a notebook, open any notebook located in the User files section of your workspace. Cliquez sur la cellule à modifier.Click on the cell you wish to edit.

Vous pouvez modifier le bloc-notes sans vous connecter à une instance de calcul.You can edit the notebook without connecting to a compute instance. Lorsque vous souhaitez exécuter les cellules du bloc-notes, sélectionnez ou créez une instance de calcul.When you want to run the cells in the notebook, select or create a compute instance. Si vous sélectionnez une instance de calcul arrêtée, elle démarre automatiquement lorsque vous exécutez la première cellule.If you select a stopped compute instance, it will automatically start when you run the first cell.

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 bloc-notes Python.When a compute instance is running, you can also use code completion, powered by Intellisense, in any Python Notebook.

Vous pouvez également lancer Jupyter ou JupyterLab à partir de la barre d’outils du bloc-notes.You can also launch Jupyter or JupyterLab from the Notebook toolbar. 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.Azure Machine Learning does not provide updates and fix bugs from Jupyter or JupyterLab as they are Open Source products outside of the boundary of Microsoft Support.

Mode focusFocus mode

Utilisez le mode focus pour développer votre affichage actuel afin de pouvoir vous concentrer sur vos onglets actifs.Use focus mode to expand your current view so you can focus on your active tabs. Le mode focus masque l’explorateur de fichiers Notebooks.Focus mode hides the Notebooks file explorer.

  1. Dans la barre d’outils de la fenêtre du terminal, sélectionnez Mode focus pour activer le mode focus.In the terminal window toolbar, select Focus mode to turn on focus mode. En fonction de la largeur de la fenêtre, il peut se trouver sous l’élément de menu dans la barre d’outils.Depending on your window width, this may be located under the ... menu item in your toolbar.

  2. En mode focus, revenez à l’affichage standard en sélectionnant Affichage standard.While in focus mode, return to the standard view by selecting Standard view.

    Activer/désactiver le mode focus et l’affichage standard

Utiliser IntelliSenseUse IntelliSense

IntelliSense est une aide à la saisie semi-automatique de code qui comprend un certain nombre de fonctionnalités : Liste des membres, Informations sur les paramètres, Info Express et Compléter le mot.IntelliSense is a code-completion aid that includes a number of features: List Members, Parameter Info, Quick Info, and Complete Word. Ces fonctionnalités vous aident à en savoir plus sur le code que vous utilisez, à suivre les paramètres que vous entrez et à ajouter des appels aux propriétés et aux méthodes avec seulement quelques séquences de touches.These features help you to learn more about the code you're using, keep track of the parameters you're typing, and add calls to properties and methods with only a few keystrokes.

Lorsque vous entrez du code, utilisez Ctrl + Espace pour déclencher IntelliSense.When typing code, use Ctrl+Space to trigger IntelliSense.

Nettoyer votre notebook (préversion)Clean your notebook (preview)

Importante

La fonctionnalité Gather (Assembler) est actuellement en préversion publique.The gather feature is currently in public preview. La préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail en production.The preview version is provided without a service level agreement, and it's not recommended for production workloads. Certaines fonctionnalités peuvent être limitées ou non prises en charge.Certain features might not be supported or might have constrained capabilities. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

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.Over the course of creating a notebook, you typically end up with cells you used for data exploration or debugging. La fonctionnalité Gather (Assembler) vous permet de créer un notebook propre sans ces cellules superflues.The gather feature will help you produce a clean notebook without these extraneous cells.

  1. Exécutez toutes les cellules de votre notebook.Run all of your notebook cells.
  2. Sélectionnez la cellule qui contient le code que vous souhaitez que le nouveau notebook exécute.Select the cell containing the code you wish the new notebook to run. Par exemple, le code qui soumet une expérience ou le code qui inscrit un modèle.For example, the code that submits an experiment, or perhaps the code that registers a model.
  3. Sélectionnez l’icône Gather (Assembler) qui apparaît dans la barre d’outils de la cellule.Select the Gather icon that appears on the cell toolbar. Capture d’écran : sélectionner l’icône Gather (Assembler)
  4. Entrez le nom de votre nouveau notebook « assemblé ».Enter the name for your new "gathered" notebook.

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.The new notebook contains only code cells, with all cells required to produce the same results as the cell you selected for gathering.

Enregistrement et point de contrôle d’un bloc-notesSave and checkpoint a notebook

Azure Machine Learning crée un fichier de point de contrôle lorsque vous créez un fichier ipynb.Azure Machine Learning creates a checkpoint file when you create an ipynb file.

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.In the notebook toolbar, select the menu and then File>Save and checkpoint to manually save the notebook and it will add a checkpoint file associated with the notebook.

Capture d’écran de l’outil d’enregistrement dans la barre d’outils du bloc-notes

Chaque bloc-notes est enregistré de façon automatique toutes les 30 secondes.Every notebook is autosaved every 30 seconds. L’enregistrement automatique met à jour uniquement le fichier ipynb initial, et non le fichier de point de contrôle.Autosave updates only the initial ipynb file, not the checkpoint file.

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é.Select Checkpoints in the notebook menu to create a named checkpoint and to revert the notebook to a saved checkpoint.

Raccourcis clavier utilesUseful keyboard shortcuts

ClavierKeyboard ActionAction
Maj + EntréeShift+Enter Exécuter une celluleRun a cell
Ctrl+EspaceCtrl+Space Activer IntelliSenseActivate IntelliSense
Ctrl + M (Windows)Ctrl+M(Windows) Activer/désactiver le recouvrement par tabulation dans le bloc-notes.Enable/disable tab trapping in notebook.
Ctrl + Maj + M (Mac & Linux)Ctrl+Shift+M(Mac & Linux) Activer/désactiver le recouvrement par tabulation dans le bloc-notes.Enable/disable tab trapping in notebook.
Tab (quand le recouvrement par tabulation est activé)Tab (when tab trap enabled) Ajouter un caractère « \t » (retrait)Add a '\t' character (indent)
Tab (quand le recouvrement par tabulation est désactivé)Tab (when tab trap disabled) Déplacer le focus vers le prochain élément sur lequel il est possible de le positionner (bouton de suppression de cellule, bouton d’exécution, etc.)Change focus to next focusable item (delete cell button, run button, etc.)

Supprimer un bloc-notesDelete a notebook

Vous ne pouvez pas supprimer les exemples de blocs-notes.You can't delete the Samples notebooks. Ces blocs-notes font partie du studio et sont mis à jour à chaque publication d’un nouveau Kit de développement logiciel (SDK).These notebooks are part of the studio and are updated each time a new SDK is published.

Vous pouvez supprimer des blocs-notes Fichiers utilisateur de l’une des manières suivantes :You can delete User files notebooks in any of these ways:

  • Dans le studio, sélectionnez les points de suspension ( ... ) à la fin d’un nom de dossier ou de fichier.In the studio, select the ... at the end of a folder or file. Veillez à utiliser un navigateur pris en charge (Microsoft Edge, chrome ou Firefox).Make sure to use a supported browser (Microsoft Edge, Chrome, or Firefox).
  • Dans n’importe quelle barre d’outils de bloc-notes, sélectionnez Ouvrir le terminal pour accéder à la fenêtre de terminal de l’instance de calcul.From any Notebook toolbar, select Open terminal to access the terminal window for the compute instance.
  • Dans Jupyter ou JupyterLab, avec leurs outils.In either Jupyter or JupyterLab with their tools.

Exécuter une expérienceRun an experiment

Pour exécuter une expérience à partir d’un bloc-notes, vous devez d’abord vous connecter à une instance de calcul en cours d’exécution.To run an experiment from a Notebook, you first connect to a running compute instance. Si vous n’avez pas d’instance de calcul, procédez comme suit pour en créer une :If you don't have a compute instance, use these steps to create one:

  1. Sélectionnez + dans la barre d’outils du bloc-notes.Select + in the Notebook toolbar.
  2. Nommez l’instance de calcul, puis choisissez une taille de machine virtuelle.Name the Compute and choose a Virtual Machine Size.
  3. Sélectionnez Create (Créer).Select Create.
  4. L’instance de calcul est automatiquement connectée au bloc-notes et vous pouvez maintenant exécuter vos cellules.The compute instance is connected to the Notebook automatically and you can now run your cells.

Vous seul pouvez voir et utiliser les instances de calcul que vous créez.Only you can see and use the compute instances you create. 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.Your User files are stored separately from the VM and are shared among all compute instances in the workspace.

Afficher les journaux et la sortieView logs and output

Utilisez des widgets de bloc-notes pour afficher la progression de l’exécution et les journaux.Use Notebook widgets to view the progress of the run and logs. Un widget est asynchrone et fournit des mises à jour jusqu’à ce que l’apprentissage se termine.A widget is asynchronous and provides updates until training finishes. Les widgets d’Azure Machine Learning sont également pris en charge dans Jupyter et JupterLab.Azure Machine Learning widgets are also supported in Jupyter and JupterLab.

Modifier l’environnement du bloc-notesChange the notebook environment

La barre d’outils du bloc-notes vous permet de modifier l’environnement d’exécution de votre bloc-notes.The Notebook toolbar allows you to change the environment on which your Notebook runs.

Ces actions ne modifient pas l’état du bloc-notes ou les valeurs des variables dans celui-ci :These actions will not change the notebook state or the values of any variables in the notebook:

ActionAction RésultatsResult
Arrêter le noyauStop the kernel Arrête toute cellule en cours d’exécution.Stops any running cell. L’exécution d’une cellule entraîne automatiquement le redémarrage du noyau.Running a cell will automatically restart the kernel.
Naviguer vers une autre section de l’espace de travailNavigate to another workspace section Les cellules en cours d’exécution sont arrêtées.Running cells are stopped.

Les actions ci-après ont pour effet de réinitialiser l’état du bloc-notes et toutes les variables dans celui-ci.These actions will reset the notebook state and will reset all variables in the notebook.

ActionAction RésultatResult
Modifier le noyauChange the kernel Le bloc-notes utilise le nouveau noyau.Notebook uses new kernel
Changer d’instance de calculSwitch compute Le bloc-notes utilise automatiquement la nouvelle instance de calcul.Notebook automatically uses the new compute.
Réinitialiser l’instance de calculReset compute Redémarre quand vous tentez d’exécuter une cellule.Starts again when you try to run a cell
Arrêter l’instance de calculStop compute Aucune cellule ne s’exécute.No cells will run
Ouvrir le bloc-notes dans Jupyter ou JupyterLabOpen notebook in Jupyter or JupyterLab Le bloc-notes s’ouvre dans un nouvel onglet.Notebook opened in a new tab.

Ajouter de nouveaux noyauxAdd new kernels

Le bloc-notes trouve automatiquement tous les noyaux Jupyter installés sur l’instance de calcul connectée.The Notebook will automatically find all Jupyter kernels installed on the connected compute instance. Pour ajouter un noyau à l’instance de calcul :To add a kernel to the compute instance:

  1. Dans la barre d’outils du bloc-notes, s²électionnez Ouvrir le terminal.Select Open terminal in the Notebook toolbar.

  2. Utilisez la fenêtre de terminal pour créer un environnement.Use the terminal window to create a new environment. Par exemple, le code ci-dessous crée newenv :For example, the code below creates newenv:

    conda create -y --name newenv
    
  3. Active l’environnement.Activate the environment. Par exemple, après la création de newenv :For example, after creating newenv:

    conda activate newenv
    
  4. Installer pip et le package ipykernel dans le nouvel environnement et créer un noyau pour ce conda envInstall pip and ipykernel package to the new environment and create a kernel for that conda env

    conda install -y pip
    conda install -y ipykernel
    python -m ipykernel install --user --name newenv --display-name "Python (newenv)"
    

Nota

Pour la gestion des packages au sein d’un notebook, utilisez les fonctions magic %pip ou %conda pour installer automatiquement des packages dans le noyau en cours d’exécution , au lieu de !pip ou !conda qui se réfèrent à tous les packages (y compris les packages en dehors du noyau en cours d’exécution).For package management within a notebook, use %pip or %conda magic functions to automatically install packages into the currently-running kernel , rather than !pip or !conda which refers to all packages (including packages outside the currently-running kernel)

Vous pouvez installer n’importe lequel des noyaux Jupyter disponibles.Any of the available Jupyter Kernels can be installed.

Indicateurs d’étatStatus indicators

Un indicateur en regard de la liste déroulante Calcul affiche son état.An indicator next to the Compute dropdown shows its status. L’État est également indiqué dans la liste déroulante elle-même.The status is also shown in the dropdown itself.

CouleurColor État du calculCompute status
VertGreen Calcul en cours d’exécutionCompute running
RougeRed Échec du calculCompute failed
NoirBlack Calcul arrêtéCompute stopped
Bleu clairLight Blue Calcul en cours de création, de démarrage, de redémarrage ou de configurationCompute creating, starting, restarting, setting Up
GrisGray Calcul en cours d’arrêt ou de suppressionCompute deleting, stopping

Un indicateur en regard de la liste déroulante Noyau affiche son état.An indicator next to the Kernel dropdown shows its status.

CouleurColor État du noyauKernel status
VertGreen Noyau connecté, inactif, occupéKernel connected, idle, busy
GrisGray Tunnel non connecté.Kernel not connected

Rechercher les détails d’un calculFind compute details

Pour plus de détails sur vos instances de calcul, consultez la page Calcul dans de Studio.Find details about your compute instances on the Compute page in studio.

Étapes suivantesNext steps