Criação e visualização de um aplicativo Streamlit usando Snowsight¶
Atenção
Este recurso está disponível para contas em regiões comerciais do AWS e Microsoft Azure. AWS PrivateLink não é suportado.
Streamlit in Snowflake fornece um editor Python em Snowsight onde você pode escrever, editar e executar o código para um aplicativo Streamlit. O editor fornece preenchimento automático e exibe documentação para funções Streamlit e Snowpark.
Nota
Você pode criar aplicativos Streamlit de página única usando Snowsight, mas para implantar um aplicativo Streamlit de várias páginas, você deve usar comandos SQL. Consulte Criação de um aplicativo Streamlit usando SQL para obter mais detalhes.
Depois de implantar um aplicativo Streamlit, você poderá visualizar o aplicativo de várias páginas em Snowsight. Consulte Visualização de um aplicativo Streamlit para obter mais informações.
Criação de um aplicativo Streamlit usando Snowsight¶
Antes de criar um aplicativo Streamlit usando Snowsight, você deve atender aos seguintes pré-requisitos:
Revise o Recursos Streamlit não suportados e Limitações adicionais ao usar Streamlit in Snowflake
Certifique-se de que sua conta tenha os privilégios corretos conforme descrito em Privilégios necessários para criar e usar um aplicativo Streamlit.
Para criar um aplicativo Streamlit:
Faça login em Snowsight como um usuário com privilégio CREATE STREAMLIT no esquema no qual você deseja criar o aplicativo.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione + Streamlit.
A janela Create Streamlit App é aberta.
Digite um nome para seu aplicativo.
No menu suspenso Warehouse, selecione o warehouse onde você deseja executar seu aplicativo e executar consultas.
No menu suspenso App location, selecione o banco de dados e o esquema do seu aplicativo.
Selecione Create.
O editor Streamlit in Snowflake abre um aplicativo Streamlit de exemplo no modo visualizador. O modo visualizador permite que você veja como o aplicativo Streamlit aparece para os usuários.
A interface Streamlit in Snowflake é dividida em três painéis:
Navegador de objetos: permite ver os bancos de dados, esquemas e exibições aos quais você tem permissão de acesso.
Editor Streamlit: fornece um editor Python para seu código Streamlit.
Visualização do Streamlit: exibe o aplicativo Streamlit em execução.
Por padrão, apenas o editor Streamlit e os painéis de visualização são exibidos. Para alterar a exibição, use os botões mostrar/ocultar no canto inferior esquerdo do editor Streamlit no Snowflake.
Execução de um aplicativo Streamlit em Streamlit in Snowflake¶
Para executar um aplicativo Streamlit, selecione Run para atualizar o conteúdo no painel de visualização do Streamlit.
Gerenciamento de pacotes para um aplicativo Streamlit¶
Você pode visualizar, adicionar e remover pacotes Python externos para seu aplicativo Streamlit usando o editor Streamlit em Snowsight.
Visualização dos pacotes instalados para um aplicativo Streamlit¶
Para visualizar os pacotes instalados para um aplicativo Streamlit, faça o seguinte:
Entre em Snowsight como um usuário com o privilégio CREATE STREAMLIT.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit cujos pacotes você deseja visualizar.
Na parte superior do editor Streamlit, selecione Packages.
Snowsight exibe uma lista de pacotes instalados.
Adição de um pacote Python compatível a um aplicativo Streamlit¶
Por padrão, Streamlit in Snowflake instala os pacotes python, snowflake-snowpark e streamlit em seu ambiente. Você pode usar Snowsight para adicionar outros pacotes. Consulte o Canal Snowflake Anaconda para obter uma lista de pacotes suportados.
Para adicionar um pacote Python compatível a um aplicativo Streamlit, faça o seguinte:
Entre em Snowsight como um usuário com o privilégio CREATE STREAMLIT.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit ao qual deseja adicionar um pacote Python.
Na parte superior do editor Streamlit, selecione Packages.
No campo de texto de pesquisa, selecione um pacote na lista de pacotes suportados ou insira o nome do pacote.
Remoção de um pacote de um aplicativo Streamlit¶
Para remover um pacote de um aplicativo Streamlit, faça o seguinte:
Entre em Snowsight como um usuário com o privilégio CREATE STREAMLIT.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit do qual deseja remover um pacote Python.
Na parte superior do editor Streamlit, selecione Packages.
Selecione o ícone x ao lado do pacote que você deseja remover.
Nota
Os pacotes python, snowflake-snowpark e streamlit são instalados por padrão e não podem ser removidos.
Visualização de um aplicativo Streamlit¶
Consulte Privilégios necessários para visualizar um aplicativo Streamlit para obter informações sobre os privilégios necessários para visualizar um aplicativo Streamlit.
Para visualizar um aplicativo Streamlit, faça o seguinte:
Entre em Snowsight.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit que deseja visualizar.
O aplicativo Streamlit principal é aberto no visualizador Streamlit in Snowflake.
Opcional: se você estiver visualizando um aplicativo Streamlit de várias páginas, selecione uma guia para visualizar páginas adicionais.
Gerenciamento de aplicativos Streamlit¶
Depois de criar um aplicativo Streamlit, você pode executar tarefas adicionais relacionadas descritas nas seções a seguir.
Edição de um aplicativo Streamlit¶
Para editar um aplicativo Streamlit, faça o seguinte:
Entre em Snowsight.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit que deseja editar.
O aplicativo Streamlit principal é aberto no visualizador Streamlit in Snowflake.
Selecione Edit.
O editor Streamlit é aberto.
Atualize seu código de aplicativo.
Para visualizar as alterações feitas no aplicativo, selecione Run.
Renomeação de um aplicativo Streamlit¶
Para renomear um aplicativo Streamlit:
Entre em Snowsight como um usuário com o privilégio CREATE STREAMLIT.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit que deseja renomear.
Selecione Edit.
Selecione o nome do aplicativo no canto superior esquerdo.
Digite o novo nome na caixa de texto.
Clique fora da caixa de texto para confirmar a alteração.
Alteração do warehouse de um aplicativo Streamlit¶
Ao desenvolver, testar e executar um aplicativo Streamlit, talvez você queira modificar o warehouse usado para executar o aplicativo e as consultas. Por exemplo, talvez seja necessário usar um warehouse com mais capacidade para lidar com consultas executadas pelo aplicativo.
Para alterar o warehouse de um aplicativo Streamlit:
Entre em Snowsight como um usuário com o privilégio CREATE STREAMLIT.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit cujo warehouse você deseja alterar.
Selecione o nome do aplicativo no canto superior esquerdo.
Selecione o novo warehouse na lista suspensa.
Exclusão de um aplicativo Streamlit¶
Excluir um aplicativo Streamlit o remove permanentemente do Snowflake. Todos os usuários com quem você compartilhou o aplicativo não poderão mais visualizar e interagir com o aplicativo Streamlit. Antes de excluir um aplicativo Streamlit, certifique-se de ter salvo o código do aplicativo fora do Snowflake.
Para excluir um aplicativo Streamlit:
Entre em Snowsight como um usuário com o privilégio CREATE STREAMLIT.
Na barra de navegação à esquerda, selecione Streamlit.
Selecione o aplicativo Streamlit que deseja excluir.
Selecione Edit.
Selecione o nome do aplicativo no canto superior esquerdo.
Selecione Delete e depois selecione Delete App.
O Snowflake exclui o aplicativo Streamlit e exibe a lista atualizada de aplicativos disponíveis.