ALTER STREAMLIT¶

Modifica as propriedades de um objeto Streamlit existente.

Consulte também:: CREATE STREAMLIT, SHOW STREAMLITS, DESCRIBE STREAMLIT, DROP STREAMLIT

Sintaxe¶

ALTER STREAMLIT [ IF EXISTS ] <name> SET
  [ MAIN_FILE = '<filename>']
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>']
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

ALTER STREAMLIT [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER STREAMLIT <name> COMMIT

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

ALTER STREAMLIT <name> PULL

ALTER STREAMLIT <name> ADD LIVE VERSION FROM LAST

Copy

Para objetos Streamlit criados com ROOT_LOCATION, somente a seguinte sintaxe será aceita:

Importante

ROOT_LOCATION é um parâmetro legado e pode ser descontinuado em um lançamento futuro. Para aplicativos Streamlit criados usando ROOT_LOCATION, edição de vários arquivos e integração do Git não são compatíveis.

ALTER STREAMLIT [ IF EXISTS ] <name> SET
  [ ROOT_LOCATION = '<stage_path_and_root_directory>' ]
  [ MAIN_FILE = '<path_to_main_file>']
  [ QUERY_WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>']
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]

ALTER STREAMLIT [ IF EXISTS ] <name> RENAME TO <new_name>

Copy

Parâmetros¶

name

Identificador do objeto Streamlit. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

SET ...

Especifica a propriedade a ser definida para o objeto Streamlit:

MAIN_FILE = 'filename'

Especifica o nome do arquivo do arquivo de ponto de entrada do Streamlit. O arquivo deve estar na raiz do diretório do aplicativo e incluir o .py Extensão.

Se seu aplicativo foi criado com ROOT_LOCATION em vez de FROM, então MAIN_FILE pode ser um caminho relativo a ROOT_LOCATION.

QUERY_WAREHOUSE = warehouse_name

Especifica o warehouse em que as consultas SQL emitidas pelo aplicativo Streamlit são executadas.

COMMENT = 'string_literal'

Adiciona um comentário ou substitui um comentário existente do objeto Streamlit.

TITLE = 'app_title'

Adiciona um título para o aplicativo Streamlit exibir em Snowsight.

IMPORTS = ( 'stage_path_and_file_name_to_read' [ , ... ] )

O local (estágio), caminho e nome do(s) arquivo(s) a ser(em) importado(s).

EXTERNAL_ACCESS_INTEGRATIONS = ( integration_name [ , ... ] )

Os nomes das integrações de acesso externo necessárias para que o código do aplicativo Streamlit acesse redes externas.

ROOT_LOCATION = 'stage_path_and_root_directory'

Especifica o nome do estágio raiz e o prefixo que contém os arquivos Streamlit Python, arquivos de mídia e arquivo environment.yml. Este parâmetro deve apontar para um único diretório dentro de um estágio interno nomeado.

RENAME TO new_name

Especifica o novo identificador do objeto Streamlit. O identificador deve ser exclusivo para o esquema onde o objeto foi criado.

Para obter mais detalhes sobre os identificadores de, consulte Requisitos para identificadores.

COMMIT

Confirma as edições pendentes no LIVE versão para um novo LAST versão. Imediatamente após a confirmação, o LIVE A versão do é idêntica à do LAST versão.

PUSH

Envia as últimas alterações confirmadas para o repositório Git, usando a ramificação armazenada na versão base se TO 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.

TO git_branch_uri: Envia as alterações confirmadas para o ramo especificado.
GIT_CREDENTIALS = snowflake_secret: Especifica o segredo do Snowflake contendo as credenciais a serem usadas para autenticação no repositório.
USERNAME = git_username: Especifica um nome de usuário do Git.
PASSWORD = git_password: Especifica uma senha do Git.
NAME = git_author_name: Especifica o nome do autor do git a ser usado.
EMAIL = git_author_email: Especifica um endereço de e-mail válido para ser usado como o nome do autor do git.
COMMENT = git_push_comment: Especifica um comentário a ser incluído no git push.

ABORT

Remove a versão ativa atual do aplicativo, incluindo todas as edições feitas em Snowsight que não foram comprometidos.

PULL

Extrai as alterações mais recentes. Você deve anular a versão ativa atual antes de removê-la.

ADD LIVE VERSION FROM LAST

Cria uma nova versão ativa do aplicativo com base na última versão confirmada.

Quando o proprietário de um aplicativo Streamlit abre o aplicativo em Snowsight e não existir uma versão ativa, esse comando será executado automaticamente. Se um usuário diferente visitar o aplicativo e uma versão ativa não existir, um erro será retornado.

Requisitos de controle de acesso¶

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

Privilégio	Objeto
OWNERSHIP	Objeto Streamlit que você altera

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema. Observe que uma função com privilégio concedido em um esquema permite que essa função resolva o esquema. Por exemplo, uma função com privilégio CREATE concedido em um esquema pode criar objetos nesse esquema sem também ter USAGE concedido nesse esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso¶

Se você remover a versão ativa do aplicativo, um usuário não poderá visitar o aplicativo até que você execute uma das seguintes ações:
- Executar ALTER STREAMLIT … ADD LIVE VERSION FROM LAST no objeto Streamlit.
- Acesse o aplicativo em Snowsight com a função proprietária do aplicativo.
Se você executar o comando ALTER STREAMLIT enquanto o aplicativo Streamlit está em execução, o aplicativo não reflete as alterações que você fez.

Se você deseja que suas alterações sejam refletidas no aplicativo, você deve recarregar ou reiniciar o aplicativo.
Em relação aos metadados:

Atenção

Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.