Introdução às Streamlit in Snowflake¶

Este tópico orienta você na implantação de seu primeiro app Streamlit in Snowflake em menos de cinco minutos usando um tempo de execução de contêiner. Depois disso, dois exemplos práticos mostram como criar apps reais que consultam dados, personalizam a experiência para cada visualizador e respondem ao Snowflake.

Pré-requisitos¶

Antes de criar um app Streamlit, certifique-se de que seu administrador tenha concluído a configuração de segurança essencial para apps Streamlit.

Sua função deve ter os seguintes privilégios:


Privilégio	Objeto	Notas
USAGE	Banco de dados em que você cria o aplicativo Streamlit
CREATE STREAMLIT, USAGE	Esquema em que você cria o aplicativo Streamlit
USAGE	Pool de computação que executa o aplicativo Streamlit	Para todas as contas, o Snowflake configura um pool de computação de uso geral ao qual os usuários comuns terão acesso. Para obter mais informações, consulte Configurando os próprios pools de computação preferidos para apps Streamlit.
USAGE	Warehouse que executa consultas no aplicativo Streamlit

Para obter mais informações, consulte Privilégios necessários para criar e usar um aplicativo Streamlit.

Implantar seu primeiro app Streamlit in Snowflake¶

A maneira mais rápida de começar é criar um app Streamlit usando o código inicial padrão. Quando você cria um app sem especificar os arquivos de origem, o Snowflake fornece automaticamente um código de exemplo.

Faça login no Snowsight.
No menu de navegação, selecione Projects » Streamlit.
Selecione + Streamlit App.
Digite um nome para seu aplicativo.
Selecione um banco de dados e um esquema para criar seu app.
Selecione Run on container.
Selecione um pool de computação e um warehouse de consulta.
Selecione Create.

O Snowsight redireciona você para o editor de app. Seu app estará pronto em alguns minutos. Então, é possível visualizá-lo e editá-lo imediatamente.

Execute os seguintes comandos SQL em uma sessão SQL:

CREATE STREAMLIT my_first_app
   RUNTIME_NAME = 'SYSTEM$ST_CONTAINER_RUNTIME_PY3_11'
   COMPUTE_POOL = my_compute_pool
   QUERY_WAREHOUSE = my_warehouse;

ALTER STREAMLIT my_first_app ADD LIVE VERSION FROM LAST;

Para visualizar o app, faça login no Snowsight e, no menu de navegação, selecione Projects » Streamlit e depois escolha o seu app.

Nota

É necessário o Snowflake CLI versão 3.14.0 ou posterior. A versão 3.14+ utiliza a moderna sintaxe CREATE STREAMLIT por padrão.

Inicialize um novo projeto Streamlit:
```
snow init my_first_app --template example_streamlit
```
Navegue até o diretório do projeto:
```
cd my_first_app
```

Edite o arquivo snowflake.yml para usar um tempo de execução de contêiner:

definition_version: 2
entities:
   my_streamlit:
      type: streamlit
      identifier: my_first_app
      query_warehouse: my_warehouse
      compute_pool: my_compute_pool
      runtime_name: SYSTEM$ST_CONTAINER_RUNTIME_PY3_11
      main_file: streamlit_app.py
      artifacts:
      - streamlit_app.py

Implante o app e abra-o no seu navegador:
```
snow streamlit deploy --open
```

Editar seu aplicativo¶

Após a implantação, você poderá editar o código do app para personalizá-lo. Para fazer um teste rápido:

Faça login no Snowsight.
No menu de navegação, clique em Projects » Streamlit e selecione seu app.
Selecione Edit.
Modifique o código no streamlit_app.py.
Selecione Run para ver suas alterações.

Obtenha o local de origem do seu app:
```
DESCRIBE STREAMLIT my_first_app;
```

Copie um arquivo atualizado para esse local:

COPY FILES INTO '<live_version_location_uri>' FROM @my_stage FILES = ('streamlit_app.py');

Edite o streamlit_app.py no diretório do projeto local.
Reimplante:
```
snow streamlit deploy --replace
```

Para obter mais informações, consulte Editar o app Streamlit.

Qual é o próximo passo?¶

Agora que você tem um app em execução, faça o teste com um destes exemplos práticos:

Exemplo: Criar um painel de dados personalizado: crie um painel que consulte dados do Snowflake e personalize a exibição para cada visualizador usando st.connection e st.user.
Exemplo: Criar um formulário que grave no Snowflake: crie um formulário que grave a entrada do usuário em uma tabela do Snowflake, demonstrando st.form, gerenciamento de dependências e st.user.

Para saber mais sobre tópicos específicos:

Criar o app Streamlit: instruções detalhadas para criação de apps do Snowsight, do SQL ou da CLI.
Gerenciamento de dependências para o app Streamlit: Adicione pacotes Python ao seu aplicativo.
Ambientes de tempo de execução para apps Streamlit: Entenda os tempos de execução de contêiner e de warehouse.
Acesso à rede externa no Streamlit in Snowflake: Conecte seu app aos serviços externos.