Lorsque vous créez un notebook, les ressources et les bibliothèques Python que vous utilisez sont mises à disposition via un runtime de notebook. Ce runtime est chargé dans le conteneur de votre notebook par l’administrateur de votre site. 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).
Un numéro de version est attribué aux runtimes en fonction de leur version ArcGIS Notebook Server correspondante :
| ArcGIS Notebook Server | Version de manifeste | Date de retrait |
|---|---|---|
11.3 | 1er juin 2030 | |
11.2 | 1er novembre 2026 | |
11.1 | 1er mai 2029 | |
11.0 | 1er août 2025 | |
10.9.1 | 1er décembre 2027 | |
10.9 | 1er juin 2024 | |
10.8.1 | 1er août 2026 | |
10.7.1 | 1er juin 2025 |
Par exemple, le runtime standard pour la version 11.3 est appelé ArcGIS Notebook Server Standard 10.0.
Pour créer des notebooks, votre administrateur doit vous affecter un rôle de membre personnalisé disposant des privilèges adéquats. Il existe un privilège qui permet de créer des notebooks à l’aide du runtime standard et un autre privilège qui permet de créer des notebooks à l’aide des runtimes avancés (Advanced).
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 le runtime standard ou avancé, mais aussi n’importe quel runtime personnalisé disponible. Vous pouvez également modifier le runtime d’un notebook après sa création. La procédure à suivre est indiquée ci-après.
Remarque :
Si les deux runtimes sont disponibles dans votre organisation et que votre administrateur de site vous a accordé le privilège de créer des notebooks à l’aide du runtime avancé, tous les notebooks que vous créez utiliseront par défaut le runtime avancé.
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.
Lorsque vous créez pour la première fois un notebook à l’aide d’un runtime que vous n’avez jamais utilisé, un nouveau conteneur est lancé. Ce conteneur inclut le runtime standard, et est distinct de votre premier conteneur (qui inclut le runtime avancé). Assurez-vous que l’administrateur de votre site dispose de cette information et qu’il peut ajuster les ressources système disponibles le cas échéant.
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 d’avancé à standard, assurez-vous que le notebook n’utilise pas ArcPy ni d’autres bibliothèques seulement disponibles dans le runtime de notebook avancé. Une erreur s’affiche lorsque vous exécutez des cellules dans le notebook utilisant ces bibliothèques avec le runtime de notebook standard.
- Ouvrez la page des détails 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.
- 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.
- Cliquez sur Save (Enregistrer) pour confirmer.
Le notebook utilise désormais le runtime standard et peut être partagé avec tous les membres autorisés à accéder au runtime standard. Un second conteneur est lancé pour héberger ce notebook ArcPy n’est pas disponible dans le notebook.
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 scrapyPour 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.6Vous avez un commentaire à formuler concernant cette rubrique ?