CREATE STREAMLIT¶

Sintaxe¶

CREATE [ OR REPLACE ] STREAMLIT [ IF NOT EXISTS ] <name>
  FROM <source_location>
  MAIN_FILE = '<path_to_main_file_in_root_directory>'
  QUERY_WAREHOUSE = <warehouse_name>
  [ COMMENT = '<string_literal>' ]
  [ TITLE = '<app_title>' ]
  [ IMPORTS = ( '<stage_path_and_file_name_to_read>' [ , ... ] ) ]
  [ EXTERNAL_ACCESS_INTEGRATIONS = ( <integration_name> [ , ... ] ) ]
  [ ROOT_LOCATION = '<stage_path_and_root_directory>' ]

Parâmetros obrigatórios¶

name

Especifica o identificador (ou seja, nome) do objeto Streamlit. Este novo identificador deve ser único para o esquema no qual a tabela é criada.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais detalhes, consulte Requisitos para identificadores.

FROM source_location

Copia os arquivos de origem do local especificado para inicializar o aplicativo. Isso acontece uma vez. Por exemplo, FROM @streamlit_db.streamlit_schema.streamlit_stage.

MAIN_FILE = 'path_to_main_file_in_root_directory'

Especifica o nome do arquivo do aplicativo Streamlit Python. Este nome de arquivo é relativo ao valor de ROOT_LOCATION.

QUERY_WAREHOUSE = warehouse_name

Especifica o warehouse para executar as consultas SQL emitidas pelo aplicativo Streamlit.

Nota

Se você estiver criando ou substituindo um objeto do aplicativo Streamlit no Snowflake Native App Framework, o parâmetro QUERY_WAREHOUSE é opcional.

Parâmetros opcionais¶

COMMENT = 'string_literal'

Especifica um comentário para o objeto Streamlit.

DEFAULT: sem valor

TITLE = 'app_title'

Especifica 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'

Importante

ROOT_LOCATION é um parâmetro herdado. O Snowflake recomenda usar FROM source_location.

Para aplicativos Streamlit criados usando ROOT_LOCATION, não há suporte para edição de vários arquivos e integração com o Git.

Especifica o caminho completo para o estágio nomeado que contém os arquivos Streamlit Python, arquivos de mídia e o arquivo environment.yml, por exemplo:

ROOT_LOCATION = '@streamlit_db.streamlit_schema.streamlit_stage'

Copy

Neste exemplo, os arquivos Streamlit estão localizados em um estágio nomeado denominado streamlit_stage em um banco de dados denominado streamlit_db e esquema denominado streamlit_schema.

Nota

• Este parâmetro deve apontar para um único diretório dentro de um estágio interno nomeado.

• Estágios externos não são suportados pelo Streamlit in Snowflake.

• Se você estiver criando ou substituindo um objeto de aplicativo Streamlit dentro do Snowflake Native App Framework, use FROM 'relative_path_from_stage_root_directory' em vez de ROOT_LOCATION = 'stage_path_and_root_directory'.

Notas de uso¶

• Quando você clona um esquema ou banco de dados contendo um objeto Streamlit, o objeto Streamlit não é clonado.

• Para especificar os pacotes usados pelo aplicativo Streamlit, use um arquivo environment.yml.

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

• As cláusulas OR REPLACE e IF NOT EXISTS são mutuamente exclusivas. Elas não podem ser usadas na mesma instrução.

• Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

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 hello_streamlit
  FROM @streamlit_db.streamlit_schema.streamlit_stage
  MAIN_FILE = 'streamlit_main.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 hello_streamlit
  FROM @streamlit_db.streamlit_schema.streamlit_repo/branches/streamlit_branch/
  MAIN_FILE = 'streamlit_main.py'
  QUERY_WAREHOUSE = my_warehouse;