管理 Streamlit 应用程序的依赖项¶

仓库运行时中支持的 Streamlit 库版本¶

Streamlit in Snowflake 支持以下 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

容器运行时的外部访问集成¶

有关外部访问集成 (EAIs) 的总体概述，请参阅 外部网络访问概述。

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

依赖项文件¶

容器运行时使用 uv 进行快速、可靠的依赖项解析。uv 的工作方式类似于 pip，用于安装 Python 包，但它的性能更高，可自定义性更强。有关 uv 功能的更多信息，请参阅 uv 文档中的 功能 (https://docs.astral.sh/uv/getting-started/features/) 概述。

容器运行时在与应用程序入口点文件相同的目录中搜索依赖项文件。如果未找到依赖项文件，搜索将继续沿目录树向上进行，直到到达应用程序源位置的根目录。找到的第一个依赖项文件用于安装应用程序的依赖项。

当同一目录下存在多个依赖文件时，它们将按以下优先级顺序使用：

• requirements.txt：选择使用 时默认使用的角色和仓库。列出 Streamlit 应用程序所需的 Python 包和版本，包括 Streamlit 本身。您不能使用 requirements.txt 配置 Python 版本。

  有关 requirements.txt 格式的更多信息，请参阅 在 pip 文档中的 需求文件格式 (https://pip.pypa.io/en/stable/reference/requirements-file-format/)。

• pyproject.toml （推荐）：管理 Python 版本和依赖项。目前，仅支持 Python 版本 3.11。当您提供 pyproject.toml 文件时，uv 将生成 uv.lock 文件来锁定依赖项版本。每当您更新依赖项时，都会更新此锁定文件。若需使用 PyPI 以外的其他包索引，必须使用 pyproject.toml。

  有关 pyproject.toml 格式的更多信息，请参阅 Python 文档中的 编写 pyproject.toml (https://packaging.python.org/en/latest/guides/writing-pyproject-toml/)。

requirements.txt 是声明应用程序依赖项的最简单方法，旨在方便入门。但是，对于更高级的依赖项管理，Snowflake 建议改用 pyproject.toml。例如，这允许您锁定依赖项版本，以确保构建的可重现性。

通常，您的入口点文件和依赖项文件会位于项目目录的根目录下。但是，您的入口点文件可以位于子目录中，而您的依赖项文件可以位于同一目录或直至项目根目录的任何父级目录中。

例如，您的项目目录可能具有以下结构之一：

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

environment.yml 文件¶

要在仓库运行时环境中使用 environment.yml 文件安装依赖项，请在应用程序源代码根目录下创建或编辑该文件。如果您不提供 environment.yml 文件，Snowflake 仅您所选环境中预装的包。有关 environment.yml 结构的更多信息，请参阅 conda 文档 (https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-file-manually)。

在 Streamlit in Snowflake 仓库运行时中使用 environment.yml 文件时，适用以下限制：

• 您只能使用 Snowflake Anaconda Channel 来安装包。

• 您只能使用 仓库运行时中支持的 Streamlit 库版本 中列出的 Streamlit 版本。

• 您不能在 dependencies 部分声明 pip 包，包括指向本地包的相对路径。

以下 environment.yml 声明了 Python 3.11 和五个 Python 包：

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

Snowflake 建议固定 Streamlit 的某个版本，以防止当 Snowflake Anaconda 通道中发布新版本的 Streamlit 时，升级该应用程序。

使用 conda 进行本地开发¶

当使用 conda 在本地开发仓库运行时应用程序时，必须在您的 environment.yml 文件中包含额外的详细信息，以确保正确安装依赖项。

• 通过其 URL 识别 Snowflake Anaconda Channel：https://repo.anaconda.com/pkgs/snowflake。

• 屏蔽默认通道。

在您的 environment.yml 文件中，请使用以下两个通道：

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

如果您的 ~/.condarc 文件中存在 defaults，请将其注释掉：

channels:
  # - defaults

Snowsight 包选择器¶

除了直接为您的仓库运行时应用编辑 environment.yml 文件外，您还可以使用 Snowsight 中的内置包选择器来添加或移除应用环境中的包。包选择器仅适用于使用仓库运行时的应用程序。此外，包选择器仅显示与应用程序的当前 Python 版本兼容的包。一些与 Python 版本无关的系统库可能不会在包选择器中显示，必须手动添加到 environment.yml 中。

1. 登录 Snowsight。

2. 在导航菜单中选择 Projects » Streamlit，然后选择您的 Streamlit 应用程序。

3. 选择右上角的 Edit。

4. 在编辑器窗格的左上角，选择 Packages。

   此时会出现一个下拉窗格，并默认选中 Anaconda Packages 选项卡。

5. 执行以下任意操作：

• 要设置 Python 版本，在 Python version 选择器中，选择所需的版本。

• 要添加包，使用搜索栏按名称查找包，然后选择所需的包。

• 要移除包，在 Installed Packages 部分，选择包版本右侧的 x 图标。

• 要设置已安装包的版本，在 Installed Packages 部分，使用包名称旁边的版本选择器。

Snowflake 会自动更新您的 environment.yml 文件并重新启动您的应用程序。如果您在编辑器中打开了 environment.yml 文件，请刷新页面以查看更改。