Gerenciamento de pacotes em notebooks no Container Runtime

Atualmente, Snowflake Notebooks no Container Runtime oferecem suporte a comandos e fluxos de trabalho pip comuns para gerenciar pacotes. Isso inclui os seguintes fluxos de trabalho comuns:

  • Use uma especificação de pacote, como um arquivo requirements.txt, para configurar um ambiente de notebook.

  • Veja todos os pacotes instalados em um ambiente de notebook.

  • Desinstale pacotes.

  • Exporte uma especificação de pacote que capture o atual ambiente de notebook.

  • Atualize os pacotes no ambiente de notebook.

Além desses fluxos de trabalho, o Notebooks em Container Runtime oferece suporte a outros fluxos de trabalho pip.

Pré-requisito

Certifique-se de que uma integração de acesso externo (EAI) para PyPI está configurada no notebook ou que o repositório de artefatos está ativo na conta Snowflake. Para obter mais informações sobre PyPI EAI, consulte Habilitar as integrações de acesso externo na Snowsight. Para obter informações sobre repositório de artefatos, consulte Visão geral do repositório de artefatos.

Exibição de todos os pacotes instalados em um ambiente de notebook

  • Para visualizar uma lista completa dos pacotes atualmente instalados no ambiente de notebook e suas respectivas versões, a partir de uma célula do notebook, execute o seguinte comando:

    !pip freeze
    
    Copy

Instalação de pacotes individuais em seu ambiente de notebook

Você pode modificar o ambiente Python de seu notebook instalando pacotes individuais usando comandos pip em linha nas células do notebook.

  • Para instalar um pacote, a partir de uma célula do notebook, execute o seguinte comando:

    !pip install <package_name>
    
    Copy

Instalação de pacotes de uma especificação de pacote para configurar um ambiente de notebook

Você pode modificar o ambiente Python de seu notebook usando uma especificação de pacote, como um arquivo requirements.txt, para instalar os pacotes desejados. O exemplo a seguir mostra como instalar pacotes de um arquivo requirements.txt armazenado localmente. Você também pode instalar pacotes de um arquivo requirements.txt armazenado em um estágio interno ou externo.

  1. Carregue o arquivo requirements.txt no notebook.

    Para obter mais informações sobre o arquivo requirements.txt, consulte Formato do arquivo de requisitos.

  2. Para instalar todos os pacotes, a partir de uma célula do notebook, execute o seguinte comando:

    !pip install -r requirements.txt
    
    Copy

Atualização das versões do pacote no ambiente de notebook

  1. Em uma célula do notebook, execute um dos seguintes comandos que corresponda à versão do pacote para o qual você deseja atualizar:

    • Versão mais recente:

      !pip install <package_name> --upgrade
      
      Copy
    • Versão específica:

      !pip install <package_name> --<version>
      
      Copy
  2. Para confirmar que a atualização foi concluída, reinicie o kernel do notebook quando solicitado.

Desinstalação de pacotes de um ambiente de notebook

Conclua as etapas a seguir para desinstalar todos os pacotes que você instalou usando uma especificação de pacote no ambiente de notebook.

  1. Verifique se um arquivo requirements.txt existe no ambiente de notebook.

  2. Em uma célula no notebook, execute o seguinte comando:

    !pip uninstall -r requirements.txt
    
    Copy
  3. Para confirmar que os pacotes foram desinstalados, quando solicitado, reinicie o kernel do notebook.

Exportação de pacotes em seu ambiente de notebook como uma especificação de pacote

Você pode exportar uma especificação de pacote que capture o estado atual do ambiente de notebook. Com essa especificação do pacote, você pode replicar rapidamente o ambiente de notebook.

  1. Em uma célula no notebook, execute o seguinte comando:

    !pip list --format=freeze <filename>.txt
    
    Copy
  2. Para carregar o arquivo em um estágio, execute o seguinte comando:

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

Para obter mais informações sobre como armazenar arquivos em um estágio, consulte Armazene arquivos em um estágio Snowflake.