Configuração de Snowflake Notebooks¶

Local¶

O local é onde um objeto de notebook é armazenado. O usuário final pode consultar qualquer banco de dados e esquema a que sua função tenha acesso.

• Para alterar o contexto para um banco de dados ou esquema diferente, use os comandos USE DATABASE ou USE SCHEMA em uma célula SQL.

No tempo de execução do contêiner, a função que cria o notebook também exige o privilégio CREATE SERVICE no esquema.

As funções que possuem um esquema automaticamente têm o privilégio de criar notebooks dentro desse esquema, pois os proprietários podem criar qualquer tipo de objeto, inclusive notebooks.

Como permitir que todos criem notebooks em um local específico¶

As etapas a seguir descrevem como configurar o acesso para a criação de notebooks em um local específico, concedendo o uso em um banco de dados e esquema. Como alternativa, é possível ativar notebooks privados, que não exigem essas concessões de acesso. Para obter mais informações sobre notebooks privados, consulte Notebooks particulares.

Substitua <database> e <database.schema> pelo banco de dados e esquema específicos em que você deseja criar os notebooks:

----------------------------------
--       Location Setup         --
----------------------------------
GRANT USAGE ON DATABASE <database> TO ROLE PUBLIC;
GRANT USAGE ON SCHEMA <database.schema> TO ROLE PUBLIC;
GRANT CREATE NOTEBOOK ON SCHEMA <database.schema> TO ROLE PUBLIC;

-- For Notebooks on Container runtime, run the following:
GRANT CREATE SERVICE ON SCHEMA <database.schema> TO ROLE PUBLIC;

----------------------------------
--    Compute Resource Setup    --
----------------------------------
GRANT USAGE ON WAREHOUSE <warehouse> TO ROLE PUBLIC;

-- For Notebooks on Container runtime:
CREATE COMPUTE POOL CPU_XS
  MIN_NODES = 1
  MAX_NODES = 15
  INSTANCE_FAMILY = CPU_X64_XS;

CREATE COMPUTE POOL GPU_S
  MIN_NODES = 1
  MAX_NODES = 5
  INSTANCE_FAMILY = GPU_NV_S;

GRANT USAGE ON COMPUTE POOL CPU_XS TO ROLE PUBLIC;
GRANT USAGE ON COMPUTE POOL GPU_S TO ROLE PUBLIC;

-------------------------------------
-- Optional: External Access --
-------------------------------------

-- Example EAI
CREATE OR REPLACE NETWORK RULE allow_all_rule
MODE = 'EGRESS'
TYPE = 'HOST_PORT'
VALUE_LIST = ('0.0.0.0:443','0.0.0.0:80');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION allow_all_integration
ALLOWED_NETWORK_RULES = (allow_all_rule)
ENABLED = true;

GRANT USAGE ON INTEGRATION allow_all_integration TO ROLE PUBLIC;

Criação de uma função dedicada¶

Se quiser que apenas usuários específicos criem notebooks (supondo que eles ainda não sejam OWN de nenhum esquema), é possível criar uma função dedicada para controlar o acesso. Por exemplo:

CREATE ROLE notebooks_rl;

Conceda ROLE notebook_rl a usuários específicos. Em seguida, use o script acima para criar recursos e conceder permissões a essa função (substitua ROLE PUBLIC por ROLE notebook_rl).

Mecanismo de notebook¶

O mecanismo de notebook («kernel») e os processos Python são executados no warehouse do Notebook. A Snowflake recomenda que você comece com um warehouse X-Small para minimizar o consumo de crédito.

Enquanto você estiver usando o notebook (por exemplo, editando código, executando, reordenando ou excluindo células), ou se o notebook permanecer ativo dentro da configuração de tempo limite de inatividade, uma consulta EXECUTE NOTEBOOK será executada continuamente para indicar que o mecanismo do notebook está ativo e que uma sessão de notebook está em uso. É possível verificar o status dessa consulta em Query history. Enquanto EXECUTE NOTEBOOK estiver em execução, o warehouse do notebook também estará em execução. Quando EXECUTE NOTEBOOK for concluído, se não houver outras consultas ou trabalhos em execução no warehouse, ele será encerrado de acordo com sua política de suspensão automática.

Para encerrar a consulta EXECUTE NOTEBOOK (encerrar a sessão do notebook), siga estas etapas:

1. Selecione Active ou selecione End session no menu suspenso Active.

2. Em Query history, encontre a consulta EXECUTE NOTEBOOK correspondente e selecione Cancel query.

3. Deixe o notebook atingir o tempo limite devido à inatividade com base em sua configuração de tempo ocioso. Se os parâmetros STATEMENT_TIMEOUT_IN_SECONDS e STATEMENT_QUEUED_TIMEOUT_IN_SECONDS no warehouse do notebook forem definidos para um valor pequeno, o notebook poderá ser desligado rapidamente ou não iniciar, independentemente da atividade do usuário.

Consultas¶

SQL e as consultas do Snowpark (por exemplo, session.sql) são enviadas para o warehouse de consultas, que é usado sob demanda. Quando as consultas SQL e Snowpark terminam de ser executadas, o warehouse de consulta é suspenso se nenhum outro trabalho estiver sendo executado nele fora do notebook. Selecione o tamanho do warehouse que melhor atende às suas necessidades de desempenho de consulta. Por exemplo, você pode querer executar grandes consultas SQL ou realizar operações de computação intensiva usando o Snowpark Python que exige um warehouse maior. Para operações que exigem alto uso de memória, considere usar um warehouse otimizado para o Snowpark.

É possível alterar o warehouse de consultas em Notebook Settings. Como alternativa, é possível executar o seguinte comando em qualquer célula SQL do notebook para alterar o warehouse de consultas para todas as consultas subsequentes na sessão atual do notebook:

USE WAREHOUSE <warehouse_name>;

Tempo ocioso e reconexão¶

Cada notebook tem uma propriedade de tempo ocioso chamada IDLE_AUTO_SHUTDOWN_TIME_SECONDS com um valor padrão de 30 minutos. É possível configurar o tempo de inatividade de cada notebook no Snowsight.

1. Faça login no Snowsight.

2. Selecione Projects » Notebooks.

3. Selecione o menu de reticências verticais para configurar um novo horário.

4. Selecione Notebook settings.

5. Reinicie manualmente a sessão para que o novo tempo ocioso entre em vigor.

O tempo ocioso é acumulado sempre que não há atividade do usuário, como edição de código, execução de células, reordenação de células ou exclusão de células. Cada vez que você retoma a atividade, o tempo de inatividade é reiniciado. Quando o tempo ocioso atinge a configuração de tempo limite, a sessão do notebook é automaticamente encerrada.

Antes do tempo limite de inatividade, a sessão do notebook permanecerá ativa até que o tempo limite de inatividade seja atingido, mesmo que o usuário atualize a página, visite outras partes do Snowsight ou desligue ou coloque o computador em modo de espera. Ao reabrir o mesmo notebook, o usuário se reconecta à mesma sessão, com todos os estados e variáveis da sessão preservados, o que lhe permite continuar trabalhando sem problemas. Observe, no entanto, que o estado dos widgets do Streamlit não será mantido.

Cada usuário individual que executa o mesmo notebook tem sua própria sessão independente. Elas não interferem umas nas outras.

Recomendações para otimização do custo¶

Como administrador de conta, considere as seguintes recomendações para controlar o custo de operação dos notebooks:

• Peça às suas equipes que usem o mesmo warehouse (recomenda-se o X-Small) como um «warehouse de notebook» dedicado para executar as sessões de notebook e aumentar a simultaneidade. Observe que isso pode levar a inícios de sessão mais lentos (filas no warehouse) ou a erros de falta de memória se muitos notebooks forem executados simultaneamente.

• Permita que suas equipes usem um warehouse com um valor STATEMENT_TIMEOUT_IN_SECONDS mais baixo para executar notebooks. Esse parâmetro do warehouse controla o tempo de duração de qualquer consulta, inclusive das sessões do notebook. Por exemplo, se o parâmetro for definido como 10 minutos, a sessão do notebook poderá ser executada por no máximo 10 minutos, independentemente de o usuário estar ativo na sessão do notebook durante esse tempo.

• Peça às equipes que encerrem as sessões de notebook quando não tiverem a intenção de trabalhar ativamente na sessão.

• Peça às suas equipes que minimizem a configuração de tempo limite de inatividade (por exemplo, 15 minutos) se não precisarem que a sessão seja executada por um longo período.

• Como alternativa, abra um tíquete de suporte para definir um valor padrão para o tempo ocioso que se aplique a toda a sua conta. Esse valor ainda pode ser substituído no nível do notebook pelo proprietário do notebook.