Streamlit in Snowflake: habilitar a integração do Git e a edição de vários arquivos para aplicativos Streamlit in Snowflake (Pendente)¶
Atenção
Essa mudança de comportamento está no pacote 2025_01.
Para saber o status atual do pacote, consulte Histórico do pacote.
Os aplicativos Streamlit in Snowflake se comportam da seguinte forma:
- Antes da mudança:
A integração do Git e a edição de vários arquivos para aplicativos Streamlit in Snowflake não são compatíveis com a Snowsight.
- Após a mudança:
A integração do Git e a edição de vários arquivos são compatíveis com os novos aplicativos Streamlit in Snowflake e incluem alterações nas seguintes áreas:
-
Oferece suporte à conexão de aplicativos Streamlit in Snowflake a um repositório Git.
Oferece suporte à criação de aplicativos Streamlit in Snowflake a partir de um repositório Git.
Oferece suporte à edição de vários arquivos na própria Snowsight.
Nota
Os aplicativos Streamlit in Snowflake existentes que usam ROOT_LOCATION funcionam como antes, mas não há suporte para a integração do Git e a edição de vários arquivos.
-
Snowsight¶
Criar um aplicativo Streamlit in Snowflake a partir de um arquivo em um repositório Git¶
Para criar um aplicativo Streamlit a partir de um arquivo em um repositório Git, faça o seguinte:
Faça login no Snowsight.
Selecione Projects » Streamlit.
Ao lado de + Streamlit, abra o menu suspenso e selecione Create from repository.
Para File location in repository, selecione o repositório e a ramificação no repositório que contém o arquivo do aplicativo Streamlit e, em seguida, selecione o arquivo
.py
específico. Para obter detalhes sobre como conectar o Snowflake ao seu repositório Git, consulte Configuração do Snowflake para usar o Git.Para App location, selecione um banco de dados e um esquema para conter o aplicativo Streamlit. Isso não pode ser alterado depois que você criar o aplicativo.
Para Query warehouse e App warehouse, selecione um warehouse.
Selecione Create para criar um aplicativo Streamlit a partir do arquivo
.py
no seu repositório Git.
Conectar um aplicativo Streamlit in Snowflake a um repositório Git¶
Para conectar um aplicativo Streamlit existente a um repositório Git, faça o seguinte:
Faça login no Snowsight.
Selecione Projects » Streamlit e abra ou crie um aplicativo Streamlit.
Na aba Files, ao lado do explorador de objetos de banco de dados, selecione Connect Git Repository.
Para File location in repository, selecione o repositório e a ramificação no repositório com o qual você deseja sincronizar o aplicativo Streamlit.
Selecione Select Folder.
Quando for solicitado que você confirme e envie o aplicativo para o repositório Git, selecione Push to Git.
Editar vários arquivos na Snowsight¶
Para editar vários arquivos do seu aplicativo Streamlit in Snowflake na Snowsight:
Faça login no Snowsight.
Selecione Projects » Streamlit e abra ou crie um aplicativo Streamlit.
Na guia Files, selecione um arquivo para editar.
Alterações nos comandos CREATE STREAMLIT e ALTER STREAMLIT¶
Quando esse pacote de mudança de comportamento é ativado, são introduzidas as seguintes alterações nos comandos CREATE STREAMLIT e ALTER STREAMLIT.
CREATE STREAMLIT¶
O código dos aplicativos Streamlit não precisa mais de um objeto de preparação separado; o objeto Streamlit armazena o código do aplicativo. Usando a cláusula FROM, você pode indicar o local existente para copiar o código do aplicativo Streamlit.
Sintaxe¶
CREATE [ OR REPLACE ] STREAMLIT [ IF NOT EXISTS ] <name>
[ { VERSION <version_alias_name> |
VERSION (COMMENT = <version_comment>) |
VERSION <version_alias_name> (COMMENT = <version_comment>) } ]
[ FROM <source_location>]
MAIN_FILE = '<path_to_main_file_in_root_directory>'
QUERY_WAREHOUSE = <warehouse_name>
[ COMMENT = <create_comment> ]
[ DEFAULT_VERSION = <default_version_name_or_alias> ]
[ TITLE = '<app_title>' ]
[ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
[ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]
Parâmetros obrigatórios¶
name
Nome do aplicativo Streamlit.
path_to_main_file_in_root_directory
Especifica o nome do arquivo do aplicativo Streamlit. Este nome de arquivo é relativo ao valor de
ROOT_LOCATION
.warehouse_name
Especifica o warehouse para executar as consultas SQL emitidas pelo aplicativo Streamlit.
Parâmetros opcionais¶
version_alias_name
Um nome de alias da versão especificada pelo usuário.
version_comment
Um comentário fornecido pelo usuário para essa versão.
source_location
Um local de onde os arquivos de origem são copiados.
create_comment
Especifica um comentário para o objeto Streamlit. Por padrão, não há nenhum valor.
default_version_name_or_alias
O nome da versão padrão usada.
app_title
Especifica um título para o aplicativo Streamlit a ser exibido no Snowsight.
stage_path_and_file_name_to_read
O local (estágio), caminho e nome do(s) arquivo(s) a ser(em) importado(s).
integration_name
Os nomes das integrações de acesso externo necessárias para que o código do aplicativo Streamlit acesse redes externas.
Exemplos¶
Para criar um aplicativo Streamlit a partir de um estágio, execute o comando CREATE STREAMLIT, conforme mostrado no exemplo a seguir:
CREATE STREAMLIT app
FROM @streamlit_db.streamlit_schema.streamlit_stage;
MAIN_FILE = 'streamlit_app.py'
QUERY_WAREHOUSE = my_warehouse;
Para criar um aplicativo Streamlit a partir de um repositório Git, execute o comando CREATE STREAMLIT, conforme mostrado no exemplo a seguir:
CREATE STREAMLIT app
FROM @streamlit_db.streamlit_schema.streamlit_repo/branches/streamlit_branch/;
MAIN_FILE = 'streamlit_app.py'
QUERY_WAREHOUSE = my_warehouse;
ALTER STREAMLIT¶
Quando esse pacote de alteração de comportamento é habilitado, o comando ALTER STREAMLIT é atualizado para incluir o seguinte:
Sintaxe¶
ALTER STREAMLIT <name> ADD VERSION [ [ IF NOT EXISTS] <version_alias_name> ]
FROM <source_location>
[ COMMENT = <add_version_comment> ]
ALTER STREAMLIT <name> ADD VERSION <version_name>
FROM { <snowgit_tag_uri> | <snowgit_commit_uri> }
[ COMMENT = <git_pull_comment> ]
ALTER STREAMLIT <name> ADD LIVE VERSION [ [IF NOT EXISTS] <version_alias_name> ]
[ FROM LAST ]
[ COMMENT = <add_version_comment> ]
ALTER STREAMLIT <name> VERSION <existing_version_name_or_alias>
SET ALIAS = <new_version_name_alias>
ALTER STREAMLIT <name> COMMIT [ VERSION <live_version_alias> ] [COMMENT = <version_comment>]
ALTER STREAMLIT <name> SET DEFAULT_VERSION = <version_name> | <version_name_alias>
ALTER STREAMLIT <name> PUSH [TO <git_branch_uri>] [ { GIT_CREDENTIALS = <snowflake_secret> | USERNAME = <git_username> password = <git_password> } NAME = <git_author_name> EMAIL = <git_author_email> ] [ COMMENT = <git_push_comment>]
ALTER STREAMLIT <name> ABORT [ VERSION <live_version_alias> ]
ALTER STREAMLIT <name> PULL
Parâmetros¶
name
Nome do aplicativo Streamlit.
version_alias_name
Um nome de alias da versão especificada pelo usuário.
source_location
Um local de onde os arquivos de origem são copiados. Requer o privilégio OWNERSHIP.
ALTER STREAMLIT name PUSH
Envia as últimas alterações confirmadas para o repositório Git, usando a ramificação armazenada na versão base se
git_branch_uri
não for especificado.Se a versão base não for baseada em uma ramificação do Git, isso gera um erro. Requer o privilégio OWNERSHIP.
git-branch-uri
Ramificação de destino para a qual enviar as alterações confirmadas.
git_author_name
Nome do autor do git a ser usado.
git_author_email
Um endereço de e-mail válido para ser usado como o nome do autor do git.
git_push_comment
Um comentário especificado pelo usuário a ser incluído no envio do git.
ALTER STREAMLIT name ABORT
Remove uma versão existente e exclui seus arquivos. Se nenhuma versão for especificada, live_version é excluído por padrão. Requer o privilégio OWNERSHIP.
ALTER STREAMLIT name PULL
Extrai as alterações mais recentes da origem para a versão ativa desse Streamlit. Requer o privilégio OWNERSHIP.
Novas colunas na saída DESCRIBE STREAMLIT¶
Quando esse pacote de alteração de comportamento é habilitado, a saída do comando DESCRIBE STREAMLIT inclui as seguintes novas colunas:
Nome da coluna |
Descrição |
---|---|
default_version |
Para uso futuro. |
default_version_name |
Para uso futuro. |
default_version_alias |
Para uso futuro. |
default_version_location_uri |
Para uso futuro. |
default_version_source_location_uri |
Para uso futuro. |
default_version_git_commit_hash |
Para uso futuro. |
live_version |
Cadeia de caracteres. Especifica qual versão é a versão ativa para esse aplicativo. |
live_version_name |
Cadeia de caracteres. O nome da versão ativa desse aplicativo. |
live_version_alias |
Cadeia de caracteres. O alias da versão ativa desse aplicativo. |
live_version_location_uri |
Cadeia de caracteres. O endereço URI onde os arquivos da versão ativa são armazenados. |
live_version_source_location_uri |
Cadeia de caracteres. Especifica a URI de onde live_version foi copiado. Nulo se esse Streamlit não tiver sido clonado. |
live_version_git_commit_hash |
Cadeia de caracteres. Hash hexadecimal da confirmação do git para o qual a live_version aponta. Nulo se um repositório Git não estiver conectado. |
Ref: 1888