Criação de notebooks Snowflake¶
Este tópico mostra como criar Snowflake Notebooks. Você pode acessar os Snowflake Notebooks através do Snowsight. Você pode criar um notebook com os seguintes métodos:
Dica
Você também pode criar um notebook usando SQL. Consulte CREATE NOTEBOOK.
Pré-requisitos¶
Siga as instruções de configuração para habilitar notebooks.
Você está usando uma função com os privilégios necessários.
Criação de um novo notebook¶
Para criar um notebook Snowflake, siga estes passos:
Faça login no Snowsight.
Selecione Projects » Notebooks no menu de navegação do lado esquerdo.
Selecione + Notebook.
Insira um nome para seu notebook.
Selecione um Notebook location. Este é o banco de dados e o esquema nos quais você armazenará seu notebook. Este parâmetro não pode ser alterado após a criação do notebook.
Nota
O menu suspenso Notebook location pode não mostrar bancos de dados criados após a abertura da caixa de diálogo Criar notebook. Se você não conseguir encontrar o banco de dados, esquema ou warehouse criado recentemente, tente recarregar a janela do navegador.
(Opcional) Selecione um Query warehouse para executar qualquer consulta SQL e do Snowpark gerada pelo notebook. Para obter orientação sobre o tamanho do warehouse a ser usado, consulte Recomendações de warehouse para execução dos notebooks Snowflake.
Selecione um Notebook warehouse para executar tarefas específicas do notebook. A Snowflake recomenda que você use SYSTEM$STREAMLIT_NOTEBOOK_WH, um warehouse gerenciado pelo Snowflake que é provisionado em cada conta para executar notebooks. Para obter mais detalhes, consulte Warehouse padrão para Notebooks.
(Opcional) Para salvar as seleções atuais para futuros notebooks, marque a caixa de seleção Remember these settings.
Selecione Create para criar e abrir seu notebook.
Para obter mais informações sobre como adicionar células, consulte Desenvolvimento e execução de código nos Snowflake Notebooks.
Criação de Snowflake Notebooks a partir de um arquivo existente¶
Você pode criar um notebook no Snowflake importando um arquivo com a extensão *.ipynb. Este pode ser um arquivo de notebook criado a partir de um aplicativo fora do Snowflake.
Faça login no Snowsight.
Selecione Projects » Notebooks.
Ao lado de + Notebook, abra o menu suspenso e selecione Import .ipynb file.
Usando o navegador de arquivos, navegue até o arquivo que deseja importar e abra-o.
Insira um nome para seu notebook.
Selecione um Notebook location. Este é o banco de dados e o esquema nos quais você armazenará seu notebook. Este parâmetro não pode ser alterado após a criação do notebook.
(Opcional) Altere o warehouse selecionado para usar e executar seu notebook.
Para obter orientação sobre o tamanho do warehouse a ser usado, consulte Recomendações de warehouse para execução dos notebooks Snowflake.
Selecione Create para criar e abrir seu notebook.
Nota
Se seu notebook importar pacotes Python, você deverá adicionar os pacotes ao notebook antes de poder executar o notebook importado. Consulte Importação de pacotes Python para uso em notebooks. Se o pacote que você usa em seu notebook importado não estiver disponível, seu código poderá não ser executado.
Para obter mais informações sobre como adicionar células, consulte Desenvolvimento e execução de código nos Snowflake Notebooks.
Criação de um notebook a partir de um repositório Git¶
Você pode sincronizar o desenvolvimento de seu notebook com um repositório Git. Em seguida, você pode criar Snowflake Notebooks a partir de notebooks naquele repositório Git.
Para criar um notebook a partir de um arquivo no Git, consulte Criação de um notebook a partir de um arquivo em um repositório Git.
Duplicação de um notebook existente¶
Você pode duplicar os Snowflake Notebooks existentes. Duplicar notebooks pode ser útil se você quiser, por exemplo, testar algumas alterações de código sem alterar a versão original do notebook.
Quando você duplica um notebook, o notebook copiado é criado com a mesma função e warehouse do notebook original e fica contido no mesmo banco de dados e esquema do notebook original. Por isso, não é possível duplicar um notebook para movê-lo para um banco de dados e esquema diferentes ou para alterar a propriedade.
Para duplicar um notebook, execute as seguintes etapas:
Faça login no Snowsight.
Selecione Projects » Notebooks.
Abra o notebook que deseja duplicar.
Selecione o menu de reticências verticais
e escolha Duplicate.(Opcional) Insira um nome para o notebook duplicado e selecione Duplicate.
O notebook duplicado é criado.
Na caixa de diálogo de confirmação, selecione Close para retornar ao notebook original, ou Open notebook para abrir o notebook duplicado.
Abra um notebook existente¶
Para abrir um notebook existente, siga estas etapas:
Faça login no Snowsight.
Selecione Notebooks.
Revise a lista de notebooks.
Você pode ver todos os notebooks pertencentes à sua função ativa ou pertencentes a uma função herdada pela sua função ativa.
Selecione um notebook para abri-lo para edição.
Para obter mais detalhes sobre a edição de notebooks, consulte Desenvolvimento e execução de código nos Snowflake Notebooks.
Ao abrir um notebook, você pode ver os resultados armazenados em cache da última vez que executou alguma célula no notebook. O notebook fica no estado Not connected por padrão, mas se você selecionar esse estado ou executar qualquer célula, seu notebook se conectará ao seu warehouse virtual.