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:

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:

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit.

  3. Ao lado de + Streamlit, abra o menu suspenso e selecione Create from repository.

  4. 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.

  5. 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.

  6. Para Query warehouse e App warehouse, selecione um warehouse.

  7. 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:

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit e abra ou crie um aplicativo Streamlit.

  3. Na aba Files, ao lado do explorador de objetos de banco de dados, selecione Connect Git Repository.

  4. 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.

  5. Selecione Select Folder.

  6. 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:

  1. Faça login no Snowsight.

  2. Selecione Projects » Streamlit e abra ou crie um aplicativo Streamlit.

  3. 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> [ , ... ] ) ]
Copy
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;
Copy

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;
Copy

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
Copy

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