Gérer les paquets dans les notebooks sur Container Runtime

Snowflake Notebooks sur Container Runtime prend actuellement en charge les commandes et les flux de travail pip courants pour la gestion des paquets. Cela comprend les flux de travail courants suivants :

  • Utilisation d’une spécification de paquet, comme un fichier requirements.txt, pour configurer un environnement notebook.

  • Visualisation de tous les paquets installés dans un environnement notebook.

  • Désinstallation des paquets.

  • Exportation d’une spécification de paquet qui capture l’environnement notebook actuel.

  • Mise à jour des paquets dans l’environnement notebook.

Outre ces flux de travail, Notebooks sur Container Runtime prend en charge d’autres flux de travail pip.

Conditions préalables

Assurez-vous qu’une intégration d’accès externe (EAI) pour PyPI est configurée dans le notebook ou que Artifact Repository est actif dans le compte Snowflake. Pour plus d’informations sur les PyPI, voir EAI. Pour plus d’informations sur le Artifact Repository, consultez Aperçu d’Artifact Repository.

Visualisation de tous les paquets installés dans un environnement notebook

  • Pour voir la liste complète des paquets actuellement installés dans l’environnement notebook et leurs versions respectives, à partir d’une cellule du notebook, exécutez la commande suivante :

    !pip freeze
    
    Copy

Installation des paquets individuels dans votre environnement notebook

Vous pouvez modifier l’environnement Python de votre notebook en installant des paquets individuels en utilisant des commandes pip en ligne dans les cellules de votre notebook.

  • Pour installer un paquet, à partir d’une cellule de notebook, exécutez la commande suivante :

    !pip install <package_name>
    
    Copy

Installation de paquets à partir d’une spécification de paquet pour configurer un environnement notebook

Vous pouvez modifier l’environnement Python de votre notebook à l’aide d’une spécification de paquet, comme un fichier requirements.txt, pour installer les paquets souhaités. L’exemple suivant montre comment installer des paquets à partir d’un fichier requirements.txt stocké localement. Vous pouvez également installer des paquets à partir d’un fichier requirements.txt stocké dans une zone de préparation interne ou externe.

  1. Charger le fichier requirements.txt vers le notebook.

    Pour plus d’informations sur le fichier requirements.txt, consultez le Format de fichier d’exigences.

  2. Pour installer tous les paquets, à partir d’une cellule du notebook, exécutez la commande suivante :

    !pip install -r requirements.txt
    
    Copy

Mise à jour des versions des paquets dans l’environnement notebook

  1. À partir d’une cellule de notebook, exécutez l’une des commandes suivantes qui correspond à la version du paquet que vous souhaitez mettre à jour :

    • Dernière version :

      !pip install <package_name> --upgrade
      
      Copy
    • Version spécifique :

      !pip install <package_name> --<version>
      
      Copy
  2. Pour confirmer que la mise à jour est terminée, lorsque vous y êtes invité, redémarrez le noyau du notebook.

Désinstallation de paquets à partir d’un environnement notebook

Effectuez les étapes suivantes pour désinstaller tous les paquets que vous avez installés en utilisant une spécification de paquet dans l’environnement notebook.

  1. Vérifiez qu’un fichier requirements.txt existe dans l’environnement notebook.

  2. À partir d’une cellule du notebook, exécutez la commande suivante :

    !pip uninstall -r requirements.txt
    
    Copy
  3. Pour confirmer que les paquets ont été désinstallés, lorsque vous y êtes invité, redémarrez le noyau du notebook.

Exportation des paquets dans votre environnement notebook en tant que spécification de paquets

Vous pouvez exporter une spécification de paquet qui capture l’état actuel de l’environnement notebook. Avec cette spécification de paquet, vous pouvez rapidement reproduire l’environnement notebook.

  1. À partir d’une cellule du notebook, exécutez la commande suivante :

    !pip list --format=freeze <filename>.txt
    
    Copy
  2. Pour charger le fichier vers une zone de préparation, exécutez la commande suivante :

    session.file.put("<path to file>/<filename>.txt", "@mystage/prefix1")
    
    Copy

Pour plus d’informations sur le stockage des fichiers dans une zone de préparation, consultez Stocker les fichiers dans une zone de préparation Snowflake.