Gerenciamento de dependências para o app Streamlit¶

Versões compatíveis da biblioteca Streamlit em tempos de execução de warehouse¶

Streamlit in Snowflake suporta as seguintes versões da biblioteca de código aberto Streamlit:

• 1.51.0

• 1.50.0

• 1.49.1

• 1.48.0

• 1.47.0

• 1.46.1

• 1.45.1

• 1.45.0

• 1.44.1

• 1.44.0

• 1.42.0

• 1.39.0

• 1.35.0

• 1.31.1

• 1.29.0

• 1.26.0

• 1.22.0

Integrações de acesso externo para tempos de execução de contêiner¶

Para uma visão geral das integrações de acesso externo (EAIs), consulte Visão geral do acesso à rede externa.

CREATE OR REPLACE NETWORK RULE pypi_network_rule
  MODE = EGRESS
  TYPE = HOST_PORT
  VALUE_LIST = ('pypi.org', 'pypi.python.org', 'pythonhosted.org', 'files.pythonhosted.org');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION pypi_access_integration
  ALLOWED_NETWORK_RULES = (pypi_network_rule)
  ENABLED = true;

GRANT USAGE ON EXTERNAL ACCESS INTEGRATION pypi_access_integration TO ROLE app_developer_role;

ALTER STREAMLIT my_app SET
  EXTERNAL_ACCESS_INTEGRATIONS = (pypi_access_integration);

Arquivos de dependência¶

Os tempos de execução de contêiner usam o uv para resolução de dependência rápida e confiável. O uv funciona como o pip para instalar pacotes Python, porém é mais eficiente e personalizável. Para obter mais informações sobre os recursos do uv, consulte a visão geral de recursos na documentação do uv.

Os tempos de execução de contêiner pesquisam arquivos de dependência no mesmo diretório que o arquivo de ponto de entrada do seu app. Se nenhum arquivo de dependência for encontrado, a pesquisa continuará subindo a árvore de diretórios até chegar à raiz do local de origem do seu app. O primeiro arquivo de dependência encontrado é usado para instalar as dependências do seu app.

Quando existem vários arquivos de dependência no mesmo diretório, eles são usados na seguinte ordem de precedência:

• requirements.txt: lista os pacotes e as versões do Python necessários para seu app Streamlit, incluindo o próprio Streamlit. Você não pode configurar sua versão do Python com requirements.txt.

  Para obter mais informações sobre o formato do requirements.txt, consulte Requirements File Format na documentação do pip.

• pyproject.toml (recomendado): gerencia sua versão e as dependências do Python. Atualmente, somente a versão 3.11 do Python é compatível. Quando você fornece um arquivo pyproject.toml, o uv gera um arquivo uv.lock para bloquear as versões de dependência. Esse arquivo de bloqueio será atualizado sempre que você atualizar as dependências. Você deverá usar o pyproject.toml se quiser usar um índice de pacotes diferente do PyPI.

  Para obter mais informações sobre o formato do pyproject.toml, consulte Writing your pyproject.toml na documentação do Python.

O requirements.txt é a maneira mais simples de declarar as dependências do seu app e é fornecido para facilitar os primeiros passos. Entretanto, para um gerenciamento de dependências mais avançado, a Snowflake recomenda o uso do pyproject.toml. Por exemplo, ele permite que você bloqueie as versões de dependência para garantir que suas compilações sejam reproduzíveis.

Geralmente, seus arquivos de ponto de entrada e de dependência estão na raiz do diretório do seu projeto. Entretanto, o arquivo de ponto de entrada pode estar em um subdiretório e o arquivo de dependência pode estar no mesmo diretório ou em qualquer pai até a raiz do seu projeto.

Por exemplo, o diretório do seu projeto pode ter uma das seguintes estruturas:

source_directory/
├── requirements.txt
└── streamlit_app.py

source_directory/
├── pyproject.toml
├── streamlit_app.py
└── uv.lock

source_directory/
├── pyproject.toml
├── subdirectory/
│   └── streamlit_app.py
└── uv.lock

source_directory/
└── subdirectory/
    ├── pyproject.toml
    ├── streamlit_app.py
    └── uv.lock

[project]
name = "my-streamlit-app"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "streamlit[snowflake]==1.50.0",
    "pandas>=2.0.0",
    "plotly>5.0.0",
    "requests>2.0.0,<3.0.0"
]

streamlit[snowflake]==1.50.0
pandas>=2.0.0
plotly>5.0.0
requests>2.0.0,<3.0.0

[project]
name = "my-streamlit-app"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "streamlit[snowflake]==1.50.0",
    "pandas>=2.0.0",
    "plotly>=5.0.0",
    "requests>2.0.0,<3.0.0"
]

[[tool.uv.index]]
name = "jfrog"
url = "<server_name>.jfrog.io/artifactory/api/pypi/<repository_key>/simple"
default = true

[[tool.uv.index]]
name = "jfrog"
url = "https://<username>:<access_token>@<server_name>.jfrog.io/artifactory/api/pypi/<repository_key>/simple"
default = true

Arquivo environment.yml¶

Para instalar dependências em seu ambiente de tempo de execução de warehouse usando um arquivo environment.yml, crie ou edite o arquivo na raiz do local de origem do seu app. Se você não fornecer um arquivo environment.yml, o Snowflake usará apenas os pacotes pré-instalados para seu ambiente selecionado. Para obter mais informações sobre a estrutura do environment.yml, consulte a documentação do conda.

As seguintes limitações se aplicam ao usar arquivos environment.yml em tempos de execução de warehouse Streamlit in Snowflake:

• Você só pode usar o canal Snowflake Anaconda para instalar pacotes.

• Você só pode usar as versões do Streamlit listadas em Versões compatíveis da biblioteca Streamlit em tempos de execução de warehouse.

• Você não pode declarar pacotes pip na seção dependencies, incluindo caminhos relativos para pacotes locais.

O seguinte environment.yml declara o Python 3.11 e cinco pacotes Python:

name: my-streamlit-app
channels:
  - snowflake
dependencies:
  - python=3.11
  - streamlit=1.50.0
  - pandas=2.*
  - plotly=5.0.*
  - requests
  - snowflake-snowpark-python

A Snowflake recomenda fixar uma versão do Streamlit para evitar que o aplicativo seja atualizado quando uma nova versão do Streamlit estiver disponível no Snowflake Anaconda Channel.

Desenvolvimento local com conda¶

Ao desenvolver seu app de tempo de execução de warehouse localmente com o conda, você deve incluir detalhes adicionais no arquivo environment.yml para garantir que as dependências sejam instaladas corretamente.

• Identifique o canal Snowflake Anaconda por seu URL: https://repo.anaconda.com/pkgs/snowflake.

• Bloqueie o canal padrão.

No arquivo environment.yml, use os dois canais a seguir:

channels:
  - https://repo.anaconda.com/pkgs/snowflake
  - nodefaults

Se defaults aparecer no arquivo ~/.condarc, comente-o:

channels:
  # - defaults

Seletor de pacotes do Snowsight¶

Além de editar o arquivo environment.yml diretamente para seu app de tempo de execução de warehouse, você pode usar o seletor de pacotes integrado no Snowsight para adicionar ou remover pacotes do ambiente do app. O seletor de pacotes só está disponível para apps que usam tempos de execução de warehouse. Além disso, o seletor de pacotes exibe apenas pacotes compatíveis com a versão atual do Python do seu app. Algumas bibliotecas do sistema independentes da versão do Python podem não ser mostradas no seletor de pacotes e devem ser adicionadas manualmente ao environment.yml.

1. Faça login no Snowsight.

2. No menu de navegação, clique em Projects » Streamlit e selecione seu app Streamlit.

3. No canto superior direito, selecione Edit.

4. No canto superior esquerdo do painel do editor, selecione Packages.

   Um painel suspenso é exibido com a guia Anaconda Packages selecionada.

5. Execute qualquer uma das seguintes ações:

• Para definir a versão do Python, no seletor de Python version, escolha a versão desejada.

• Para adicionar um pacote, use a barra de pesquisa para encontrar pacotes por nome e selecione o pacote desejado.

• Para remover um pacote, na seção Installed Packages, selecione o ícone x à direita da versão do pacote.

• Para definir a versão de um pacote instalado, na seção Installed Packages, use o seletor de versões ao lado do nome do pacote.

O Snowflake atualiza o arquivo environment.yml automaticamente e reinicia seu app. Se você o arquivo environment.yml estiver aberto no editor, atualize a página para ver as alterações.