Explicação dos diferentes tipos de objetos Streamlit¶

Os objetos Streamlit no Snowflake têm duas diferenças importantes que influenciam seus recursos, limitações e gerenciamento:

Como o local de origem é especificado: usando o parâmetro ROOT_LOCATION (legado) ou FROM (recomendado).
O ambiente de tempo de execução: tempo de execução de warehouse ou de contêiner (versão preliminar).

Esta página explica as diferenças entre as especificações do local de origem que, por sua vez, afetam os ambientes de tempo de execução que podem ser usados.

Para obter mais informações sobre os ambientes de tempo de execução, consulte Ambientes de tempo de execução para apps Streamlit. Para conferir uma lista de verificação para migrar do tempo de execução de warehouse para o de contêiner, consulte Migração entre ambientes de tempo de execução.

Localização de origem¶

Ao criar apps Streamlit no Snowflake, você pode usar dois parâmetros diferentes para especificar o local dos seus arquivos de origem: ROOT_LOCATION ou FROM. ROOT_LOCATION é um parâmetro legado que tem diversas restrições. Atualmente, FROM é o parâmetro recomendado para novos apps e necessário para acessar os recursos do Streamlit in Snowflake mais recentes, incluindo os tempos de execução de contêiner. Esta página explica como diferenciar entre os dois tipos de apps. Para habilitar os recursos do Streamlit in Snowflake mais recentes, atualize os Streamlits legados. Para obter mais informações, consulte Migração entre ambientes de tempo de execução.

Parâmetro FROM (recomendado)¶

O parâmetro FROM copia arquivos de um local especificado para uma área de preparação incorporada no objeto Streamlit. Essa é a abordagem atual recomendada para criar apps Streamlit.

Benefícios:

Oferece suporte aos tempos de execução de warehouse e de contêiner.
Permite a edição de vários arquivos no Snowsight.
Compatível com os recursos de integração do Git.
Usa uma área de preparação incorporada e com controle de versão no objeto Streamlit.

Sintaxe:

CREATE STREAMLIT my_app
FROM '@my_stage/app_folder'
MAIN_FILE = 'streamlit_app.py';

Copy

Parâmetro ROOT_LOCATION (legado)¶

O parâmetro ROOT_LOCATION cria um app que faz referência a uma área de preparação interna como origem. Essa é uma abordagem legada com várias limitações. Se você criou seu app usando uma versão mais antiga do Snowsight, o local raiz do app pode ser um URL snow (snow://) em vez de uma área de preparação nomeada.

Limitações:

Oferece suporte apenas ao tempo de execução de warehouse (não é possível usar o tempo de execução de contêiner).
Sem suporte para edição de vários arquivos no Snowsight.
Não é possível usar os recursos de integração do Git.
Requer acesso contínuo à área de preparação interna.

Sintaxe:

CREATE STREAMLIT my_app
ROOT_LOCATION = '@my_stage/app_folder'
MAIN_FILE = '/streamlit_app.py';

Copy

Identificação do tipo de local de origem do app¶

Você pode determinar qual parâmetro foi usado para criar seu app examinando a saída de DESCRIBE STREAMLIT:

DESCRIBE STREAMLIT my_app;

Copy

Os aplicativos baseados em ROOT_LOCATION retornam menos colunas e incluem uma coluna root_location.
Os aplicativos baseados em FROM retornam mais colunas e incluem uma coluna live_version_location_uri.

Quando você edita um app no Snowsight, envia atualizações para root_location ou live_version_location_uri, dependendo do tipo de app. Você pode atualizar ambos os tipos de apps usando comandos SQL para PUT ou COPY FILES nesses locais.