Criação de notebooks Snowflake¶
Este tópico descreve como criar o Snowflake Notebooks em um tempo de execução de warehouse. Você também pode criar Snowflake Notebooks no tempo de execução do contêiner para ML. Para obter mais detalhes, consulte Criar um notebook no Container Runtime for ML.
É possível acessar os notebooks por meio do Snowsight, onde é possível:
Dica
Você também pode criar um notebook usando SQL. Consulte CREATE NOTEBOOK.
Pré-requisitos¶
Você está usando uma função com os privilégios necessários. Se estiver criando um notebook privado, você atende aos pré-requisitos.
Criação de um novo notebook¶
É possível criar um novo notebook selecionando + Notebook, ou você pode importar um arquivo com a extensão *.ipynb
. Pode ser um arquivo de notebook criado a partir de um aplicativo fora do Snowflake.
Para criar um novo notebook, siga estas etapas:
Faça login no Snowsight.
Selecione Projects » Notebooks no menu de navegação do lado esquerdo.
Selecione + Notebook.
Você tem várias opções ao criar um novo notebook:
Para criar um notebook de propriedade da função, selecione sua função primária atual na lista suspensa Creating as.
Para criar um notebook privado de propriedade do usuário, selecione seu nome de usuário na lista suspensa Creating as.
Para criar um notebook a partir de um arquivo existente, como um arquivo de notebook criado a partir de um aplicativo fora do Snowflake, selecione a seta para baixo ao lado de + Notebook e, em seguida, selecione Import .ipynb file. Abra o arquivo a ser importado.
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.
Insira um nome para seu notebook.
Nota
Se estiver usando uma região AWS, é possível especificar o ambiente de tempo de execução do notebook: o Container Runtime para ML ou o tempo de execução do warehouse.
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. Se você criar um notebook privado depois que os bancos de dados pessoais estiverem ativados para sua conta, o banco de dados pessoal será pré-preenchido por padrão em Notebook location. No entanto, se você estiver criando um notebook privado e houver apenas um esquema no banco de dados pessoal, as opções de Notebook location não estarão disponíveis.
Nota
O menu suspenso Notebook location pode não mostrar bancos de dados criados depois que a caixa de diálogo Create Notebook foi aberta. Se você não conseguir encontrar o banco de dados, esquema ou warehouse criado recentemente, tente recarregar a janela do navegador.
A consulta de dados no notebook não está restrita a esse local. No notebook, é possível consultar dados em qualquer local ao qual você tenha acesso. Para especificar o local, execute USE WAREHOUSE e USE SCHEMA.
Selecione Run on warehouse ou Run on container como seu ambiente Python.
(Opcional) Selecione um Query warehouse para executar qualquer consulta SQL e do Snowpark gerada pelo notebook.
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 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, em seguida, selecione Duplicate.
(Opcional) Digite um nome para o notebook duplicado e selecione Duplicate.
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 na Snowsight.
Selecione Notebooks.
Nota
Os notebooks usados recentemente também aparecem em Snowsight. Em Recently viewed, 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.