Migração de notebooks legados para Workspaces¶

Este tópico descreve como mover seus Snowflake Notebooks legados e arquivos dependentes para o ambiente do Workspaces.

Etapas de migração¶

No menu de navegação, selecione Projects » Notebooks para abrir seu notebook legado.
Navegue até a seção Files para visualizar seus notebooks .ipynb e arquivos dependentes.
Baixe todos os arquivos necessários para sua máquina local.
No menu de navegação, selecione Projects » Workspaces.
Selecione um espaço de trabalho.
Abra um espaço de trabalho existente ou crie um novo.

Escolha um espaço de trabalho privado para uso individual ou um espaço de trabalho compartilhado se os notebooks precisarem ser acessados por vários usuários. Para obter mais informações, consulte Espaços de trabalho.
Selecione + Add new.
Carregue os arquivos baixados no espaço de trabalho.

Principais diferenças entre notebooks legados e novos¶

Nota

Nem todos os arquivos de notebook legados serão executados com sucesso e podem exigir atualizações para se alinharem ao novo ambiente. A tabela abaixo descreve as atualizações disponíveis em Notebooks no Workspaces.

Área	Notebooks legados	Novos notebooks
Computação	Os usuários devem escolher entre tempo de execução de warehouse e contêiner.	Experiência do usuário simplificada apenas com tempo de execução de contêiner. Infraestrutura de CPU/GPU totalmente gerenciada. Utilização de computação mais eficiente (vários notebooks podem se conectar ao mesmo serviço/nó). O código SQL e Snowpark ainda é enviado para um warehouse para flexibilidade e custo-desempenho.
Sistema de arquivos/ambiente IDE	Parcialmente compatível	Ambiente IDE completo com: Explorador de arquivos com suporte a subpastas Painéis divididos Terminal etc. Os espaços de trabalho sincronizados com o Git permitem aos usuários efetuar push/pull, visualizar diffs e alternar ramificações. Os espaços de trabalho compartilhados oferecem suporte à colaboração em equipe com histórico de versões e fluxos de publicação simples.
Gerenciamento de pacotes	Pacotes instalados por meio do canal Anaconda. EAIs precisam ser configuradas manualmente para cada notebook. Suporte para instalação de pacotes de áreas de preparação.	Opções de gerenciamento de pacotes mais flexíveis: Carregamento direto para o Workspaces ou importação de arquivos em área de preparação/repositórios Git. Configuração mais fácil de EAIs para instalação de fontes externas. O canal Anaconda não é mais compatível.
Suporte para Streamlit	Compatível.	Sem suporte. Usar bibliotecas, como `matplotlib`, `seaborn`, `plotly` e `altair`, para visualização.
Compatibilidade com Jupyter	Alguns magics do Jupyter são compatíveis.	Suporte completo Usar magics do Jupyter, como `%run`, `%time` e `%autoreload`.

Se você tiver dúvidas sobre os cronogramas de disponibilidade de recursos específicos, peça que o representante da sua conta entre em contato com a equipe do produto Notebooks.

Requisitos técnicos e compatibilidade¶

Revise as seguintes restrições antes de executar seus notebooks no novo ambiente:

Python e Runtime: o Workspaces é compatível com Python 3.10 a 3.12 e Container Runtime 2.2.

Nota

Python 3.9 e Container Runtime 2.0 não são compatíveis com o Workspaces.
Tipos de computação: no Workspaces, notebooks são executados em tipos de computação CPU ou GPU.
Visualizações: o Streamlit não é compatível. Para visualização de dados, use Matplotlib, Seaborn, Plotly ou Altair.

Gerenciamento de dependências¶

O Workspaces não tem suporte à integração com o repositório de pacotes Snowflake Anaconda. Se seu projeto exigir pacotes não incluídos nos pacotes pré-instalados, você pode instalá-los seguindo estes métodos:

Fluxo de trabalho interativo: use pip install dentro do notebook. Para obter mais informações, consulte Gerenciando pacotes e tempo de execução.
Configuração automatizada: defina suas dependências em um arquivo requirements.txt. Para instruções detalhadas, consulte Gerenciando pacotes e tempo de execução. Para notebooks agendados, especifique o arquivo usando o parâmetro REQUIREMENTS_FILE em EXECUTE NOTEBOOK PROJECT.

Tarefas agendadas¶

Se você tiver tarefas agendadas em seus notebooks legados, elas continuarão a ser executadas com notebooks legados e não serão afetadas.

Se quiser que as tarefas existentes usem novos notebooks, atualize suas tarefas para fazer referência ao novo objeto de projeto de notebook (NPO). Para obter mais informações, consulte Executar e agendar notebooks no Workspaces.