ALTER 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

For Streamlit objects created with ROOT_LOCATION, only the following syntax is supported:

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>

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'

Specifies the root stage name and prefix containing the Streamlit Python files, media files, and environment.yml file. This parameter must point to a single directory inside a named internal stage.

RENAME TO new_name

Specifies the new identifier for the Streamlit object. The identifier must be unique for the schema where the object was created.

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.

Recurso em versão preliminar — Aberto

Disponível para todas as contas.

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.

If the base version is not based on a Git branch, this throws an error.

Recurso em versão preliminar — Aberto

Disponível para todas as contas.

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.

Recurso em versão preliminar — Aberto

Disponível para todas as contas.

PULL

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

Recurso em versão preliminar — Aberto

Disponível para todas as contas.

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:

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.