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ドキュメントの 機能 概要をご参照ください。

コンテナランタイムは、アプリのエントリポイントファイルと同じディレクトリにある依存関係ファイルを検索します。依存関係ファイルが見つからない場合、検索はアプリのソースロケーションのルートに到達するまで、ディレクトリツリーをたどります。最初に見つかった依存関係ファイルは、アプリの依存関係をインストールするために使用されます。

同じディレクトリに複数の依存関係ファイルが存在する場合、それらは以下の優先順位で使用されます。

• requirements.txt:Streamlit自体など、Streamlitアプリに必要なPythonパッケージとバージョンのリストを表示します。requirements.txt を使用してPythonバージョンを構成することはできません。

  requirements.txt の形式の詳細については、pipドキュメントの 要件ファイル形式 をご参照ください。

• pyproject.toml （推奨）：Pythonのバージョンと依存関係を管理します。現在、Pythonバージョン3.11のみがサポートされています。pyproject.toml ファイルを提供するとき、uvは uv.lock ファイルを生成して依存関係のバージョンをロックします。このロックファイルは、依存関係を更新するたびに更新されます。PyPI と異なるパッケージインデックスを使用する場合は pyproject.toml を使用する必要があります。

  pyproject.toml の形式の詳細については、Pythonドキュメント内の 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ドキュメント をご参照ください。

Streamlit in Snowflake ウェアハウスランタイムで environment.yml ファイルを使用する場合、次の制限が適用されます。

• Snowflake Anacondaチャネルのみを使用してパッケージをインストールできます。

• ウェアハウスランタイムでサポートされているStreamlitライブラリのバージョン にリストされているStreamlitバージョンのみを使用できます。

• ローカルパッケージへの相対パスなど、dependencies セクションでは pip パッケージを宣言できません。

次の environment.yml はPython 3.11と5つの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 Anaconda Channel で Streamlit の新バージョンが利用可能になったときにアプリがアップグレードされないように、Streamlit のバージョンを固定することをお勧めします。

condaによるローカル開発¶

condaを使用してウェアハウスランタイムアプリをローカルで開発する場合は、 environment.yml ファイルに追加の詳細情報を含め、依存関係が正しくインストールされるようにする必要があります。

• Snowflake Anacondaチャネルを URL: https://repo.anaconda.com/pkgs/snowflake で特定します。

• デフォルトのチャネルをブロックします。

environment.yml では、次の2つのチャネルを使用します。

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 ファイルを開いている場合は、ページを更新して変更を確認します。