Spécifier le runtime d’un notebook

Lorsque vous créez un notebook, les ressources et les bibliothèques Python que vous utilisez sont mises à disposition via un runtime de notebook. Deux runtimes sont disponibles : le runtime standard contient ArcGIS API for Python, ainsi que quelques centaines d’autres bibliothèques Python, tandis que le runtime avancé contient ces mêmes bibliothèques, avec en plus ArcPy et quelques bibliothèques connexes. Les runtimes disponibles dépendent des licences et des privilèges.

Remarque :

Les notebooks qui utilisent le runtime avancé (Advanced) peuvent exécuter ArcGIS API for Python et toutes les autres bibliothèques du runtime standard (Standard).

Pour créer des notebooks, votre administrateur doit vous affecter un rôle de membre personnalisé disposant des privilèges adéquats. Selon le runtime de notebook nécessaire, vous devez bénéficier du privilège d’utilisation du runtime standard ou du runtime avancé. Le privilège du runtime avancé vous permet également d’utiliser le runtime avancé avec GPU.

Si seul le runtime standard est disponible dans votre organisation et que votre rôle contient le privilège correspondant, vous pouvez commencer à créer des notebooks sur le champ.

Choisissez le runtime d’un notebook

Lorsque vous créez un notebook vierge, vous devez choisir quel runtime le notebook utilisera. La liste dans laquelle vous faites votre choix dépend de vos privilèges. Si vous disposez du privilège Advanced Notebooks (Notebooks avancés), vous pouvez choisir entre le runtime standard et le runtime avancé. Vous pouvez également modifier le runtime d’un notebook après sa création.

Si vous disposez des privilèges adéquats, vous pouvez créer des notebooks utilisant les deux runtimes en fonction de la situation. Par exemple, si vous créez un notebook pour le partager avec d’autres créateurs de notebooks de votre organisation qui ne disposent pas du privilège Advanced Notebooks (Notebooks avancés), vous pouvez créer un notebook à l’aide du runtime standard.

Modifier le runtime d’un notebook

Il est recommandé de mettre à jour le runtime de notebook lorsqu’une nouvelle version est disponible pour tirer profit des bibliothèques Python les plus récentes. Procédez comme suit pour modifier le runtime appliqué à un notebook existant. Seuls les membres autorisés à créer des notebooks à l’aide des deux runtimes de notebook peuvent appliquer ce processus.

Remarque :

Avant de modifier le runtime d’un notebook, vérifiez les bibliothèques disponibles et les versions de runtime correspondantes utilisées dans le notebook. Une partie du code risque de fonctionner différemment avec les différentes versions de bibliothèques. Certaines bibliothèques ne sont pas disponibles dans tous les runtimes de notebook. Par exemple, ArcPy n’est disponible que dans le runtime notebook avancé. Par conséquent, si vous passez au runtime notebook standard, une erreur s’affiche lorsque vous exécutez des cellules dans le notebook utilisant ArcPy.

1. Ouvrez la page des éléments du notebook et cliquez sur l’onglet Settings (Paramètres).

   Dans la section Notebook ce cet onglet, sous Notebook Settings (Paramètres du notebook), l’option Notebook Runtime (Runtime du notebook) indique le runtime que le notebook utilise.

2. Cliquez sur la liste déroulante et choisissez le runtime.

   Remarque :

   Si vous ne disposez pas du privilège Notebooks avancés, seul le runtime standard apparaît dans la liste déroulante.

3. Cliquez sur Save (Enregistrer) pour confirmer.

Installer des modules pendant une session

Les créateurs de notebook peuvent mettre à disposition les modules Python ou des versions des modules, qui ne sont disponibles dans aucun runtime, pendant une session de notebook à l’aide du système de gestion des paquetages conda. Il est recommandé d’utiliser conda, car ArcGIS Notebooks l’emploie pour gérer les modules.

Cette approche installe le module souhaité pendant la durée de la session de notebook. Une fois que le notebook est fermé ou que le conteneur appartenant à l’utilisateur est terminé, le module n’est plus disponible. Pour installer des modules à l’aide de cette méthode, vous devez disposer d’une connexion Internet au canal conda.

Remarque :

conda est inclus dans les deux runtimes de notebooks. Il n’est pas nécessaire de l’installer.

Pour installer le paquetage scrapy pendant une session, par exemple, exécutez une cellule de notebook avec l’une des commandes suivantes, selon le système de gestion des paquetages que vous utilisez :

Utilisation du système de gestion des paquetages conda

!conda install --yes scrapy

Pour utiliser une autre version d’un module Python dans le runtime de notebook dans lequel vous travaillez, indiquez le numéro de version dans la commande.

Après avoir exécuté une commande conda, vous devez redémarrer le noyau pour que le nouveau paquetage soit disponible.

Par exemple, un paquetage donné est disponible dans les deux runtimes de notebook version 1.5, mais vous voulez utiliser un outil introduit dans la version 1.6. Pour mettre la version 1.6 à disposition pendant une session de notebook, exécutez une cellule de notebook avec l’une des commandes suivantes, selon le système de gestion des paquetages que vous utilisez :

Utilisation du système de gestion des paquetages conda

!conda install --yes <package name>==1.6