ランタイム環境間の移行¶

前提条件¶

始める前に、ウェアハウスランタイムアプリを調整して、移行の準備をします。

オプション：アプリのコードをバックアップする

アプリのソースコードがバージョン管理システム、外部リポジトリ、またはローカルディレクトリにまだ格納されていない場合は、移行中の潜在的なデータ損失を防ぐためにバックアップしてください。

アプリが ROOT_LOCATION で作成されていないことを確認してください

ROOT_LOCATION パラメーターで作成されたアプリはウェアハウスのランタイムのみを使用できます。アプリが ROOT_LOCATION で作成された場合、 FROM パラメーターを使用するためアップグレードしてください。

さまざまなタイプのStreamlitオブジェクトについて理解する をご参照ください。

アプリをStreamlit 1.50+にアップグレードする

アプリとすべての依存関係がStreamlit 1.50+と互換性があることを確認してください。

Streamlitアプリの依存関係を管理する をご参照ください。

アプリをPython 3.11のみに更新する

コンテナランタイムはPython 3.11のみをサポートしますが、ウェアハウスランタイムはPython 3.9、3.10、3.11をサポートします。アプリとすべての依存関係がPython 3.11と互換性があることを確認してください。

Streamlitアプリの依存関係を管理する をご参照ください。

オプション：Snowflake CLI 3.14.0+をローカルにインストールする

Snowflake CLI を使用してアプリをデプロイする場合、コンテナランタイム展開構文をサポートするには、バージョン3.14.0以降が必要です。snow --version でバージョンを確認してください。オプションで、 --experimental フラグを使用する場合は、バージョン3.12.0～3.13.1を使用できます。

Snowflake CLI を使用してStreamlitアプリを作成し、デプロイします。 をご参照ください。

リソースと権限¶

アプリは既存のクエリウェアハウスを引き続き使用できますが、コンテナランタイムのコンピューティングプールを設定する必要があります。

コンピューティングプールの作成とアクセス許可

アプリ所有者はコンテナランタイムが実行されるコンピューティングプールに対する USAGE 権限が必要です。アプリのビューアーは、コンピューティングプールの権限を必要としません。

Streamlitアプリの作成と使用に必要な権限 をご参照ください。

外部アクセス統合へのアクセスの作成と付与

コンテナランタイムには、最小限のパッケージのセットがプリインストールされています。アプリで追加パッケージやプリインストールパッケージの異なるバージョンが必要な場合は、 PyPI のような外部パッケージインデックスを使用する必要があります。アプリが外部パッケージインデックスにアクセスできるようにするには、外部アクセス統合（EAI）を作成し、 EAI に対する USAGE 権限をアプリ所有者に付与する必要があります。

Streamlit in Snowflake の外部ネットワークアクセス をご参照ください。

依存関係管理¶

environment.yml を pyproject.toml または requirements.txt に置き換えます

依存関係のバージョンをロックしたり、追加の依存関係を指定したりする必要がある場合は、プロジェクトディレクトリのルートに pyproject.toml または requirements.txt ファイルを追加する必要があります。パッケージはCondaと PyPI ではパッケージ名が異なる場合がありますので、アーティファクトリポジトリには正しいパッケージ名を使用するようにしてください。

Streamlitアプリの依存関係を管理する をご参照ください。

アプリを変更して外部アクセス統合を設定する

依存関係にバージョン指定子が含まれている場合や追加パッケージをインストールする場合は、アプリに外部アクセス統合を割り当てる必要があります。これにより、依存関係ファイルで指定されたパッケージインデックスにアクセスできるようになります。 PyPI は、デフォルトのパッケージインデックスです。

Streamlitアプリの依存関係を管理する をご参照ください。

コードの変更¶

get_active_session() を st.connection("snowflake").session() に置き換えます

コンテナランタイムを使用すると、Streamlitサーバーは複数のビューアーを同時に処理します。 get_active_session() はスレッドセーフではないため、代わりに st.connection("snowflake") を使用して接続を管理する必要があります。

シークレットを管理し、Streamlitアプリを設定する をご参照ください。

コードを確認してキャッシュを実装する

コンテナランタイムはビューアセッション間でディスク、コンピューティング、およびメモリリソースを共有するため、 st.cache_resource または st.cache_data を使用して負荷の高いコンピューティングや頻繁に変更されないデータをキャッシュする必要があります。

以下をご参照ください。Streamlitドキュメント内の Streamlitのクライアントサーバーアーキテクチャの理解 および キャッシュの概要

スレッドセーフティの確保

コンテナランタイムを使用する場合、複数のビューを同時に処理するには、アプリのコードがスレッドセーフである必要があります。各ビューアーはアプリスクリプトの固有のインスタンスを取得しますが、競合状態や一貫性のない動作につながる可能性のある、共有状態やグローバル変数のインポートされたコードを確認する必要があります。Streamlitアプリに新しいスレッドを導入する場合は、Streamlitのアーキテクチャを確認し、カスタムスレッドでStreamlitコマンドを使用しないでください。

以下をご参照ください。Streamlitドキュメント内の `Streamlitのマルチスレッド<https://docs.streamlit.io/develop/concepts/design/multithreading>`_

_snowflake の使用をネイティブPythonに相当するものに置換する

_snowflake は、ユーザー定義関数（UDFs）およびストアドプロシージャでのみ使用できるプライベートモジュールです。ウェアハウスランタイムは _snowflake にアクセスを継承しますが、コンテナランタイムは継承しません。アプリで _snowflake を使用する場合、Snowflake PythonコネクタなどのネイティブPythonの同等のものに置き換えます。必要であれば、ストアドプロシージャを使用してシークレットにアクセスします。

シークレットを管理し、Streamlitアプリを設定する をご参照ください。

ファイルパスと組織を更新する

ソースロケーションのルートは、アプリの作業ディレクトリです。ほとんどのPythonライブラリでは、アプリはソースロケーションのルートからの相対パスを使用する必要があります。ただし、一部のStreamlitコマンドにはエントリポイントファイルからの相対パスが必要です。エントリポイントファイルがサブディレクトリにある場合は、それに応じてコード内のパスを確認します。

secrets.toml および config.toml の場所を確認します。

Streamlitアプリファイルを整理する をご参照ください。

アプリ構成の変更¶

アプリを変更して、コンピューティングプール、クエリウェアハウス、ランタイムを設定する

アプリのランタイムタイプを切り替える準備ができたら、 Snowsight または SQL を使用できます。

SnowsightSQL

1. Snowsight にサインインします。

2. ナビゲーションメニューで、 Projects » Streamlit を選択してから、アプリを選択します。

3. 右上隅で、垂直省略記号 メニューを選択し、 App settings を選択します。

4. Python environment には、 Run on container を選択します。

5. Compute pool ドロップダウンで、コンピューティングプールを選択します。

6. Query warehouse ドロップダウンで、クエリウェアハウスを選択します。

7. 変更を保存してダイアログを閉じるには、 Save を選択します。

アプリが再起動して新しいコンテナをビルドするために数分かかります。

Streamlitアプリのランタイム環境 をご参照ください。