Snowpark Migration Accelerator:対話型評価アプリケーションインストールガイド

このセクションでは、Snowflakeアカウントでの対話型評価アプリケーション（IAA）のデプロイについて説明します。IAA は、Snowflake内でSnowflakeのパワーを活用して、Snowpark Migration Accelerator（SMA）からの出力データを分析するStreamlitアプリです。このドキュメントでは、IAA を使用してSnowflake環境内のワークロードを分析するために必要な手順とリソースを提供します。

ステップバイステップガイド

IAA をデプロイする前に、以下の前提条件が揃っていることを確認してください。

  • [SMA]（../user-guide/assessment/output-reports/README）を実行し、分析用の出力データが準備できている。

  • Snowflakeアカウントを持っている。（これは、IAA をホストし、実行するために必要です）そうでない場合は、[Snowflakeトライアルアカウント]（https://signup.snowflake.com/?utm_cta=sit-iaa-signup?）をご利用ください。

  • ノートブックを実行するために、VSCode またはJupyterがインストールされています:[VSCode]（https://code.visualstudio.com/）または[ Jupyter]（https://jupyter.org/）

  • Python 3.11以降がインストールされていることを確認してください。このバージョンは、IAA ノートブックとの互換性のために必要です。

    • システムにはすでにPythonがインストールされている可能性があります。そうでない場合は、以下のいずれかのオプションに従ってください。

      • LinuxまたはMacの場合は、スクリプト:[ deployment/pre_req_install_python_3.sh]（https://github.com/Snowflake-Labs/IAA-Support/blob/main/deployment/pre_req_install_python_3.sh）を使用できます。

      • Windowsの場合、Pythonを持っていなければ[Python公式サイト]（https://www.python.org/downloads/）から入手できます。

      • 別の方法として、Miniconda[ docs.conda.io]（https://docs.conda.io/projects/miniconda/en/latest/）を使ってインストールすることもできます。

すべてのマッピングテーブルをアップロードすると、最新のものだけを選択するよりも時間がかかる場合があります。以前のバージョンとの比較に興味がない場合は、最新のものをアップロードすることをお勧めします

VS Codeで、APIs と EWIs バージョンのすべてのフォルダを含むマップフォルダーを選択し、アップロードしないものを削除します。この場合、7.1.2バージョンのみを残すことができます。

![アップロード可能なマッピング]（</images/migrations/sma-assets/image(556).png>）

前提条件の確認が完了したら、デプロイに進みます。

IAA をデプロイしましょう！

注釈

このステップバイステップガイドは、VS コードに適用されます

リポジトリ

  1. Snowflake Labsのオープンソース GitHub にアクセスします: [https://github.com/Snowflake-Labs/IAA-Support]（https://www.google.com/url?q=https://www.google.com/url?q=https://github.com/Snowflake-Labs/IAA-Support&source=gmail&sa=D&sa=E&source=gmail&sa=D&sa=E）

  2. 「コード」ボタンをクリックし、好みのリポジトリのクローン方法（例: HTTPS または SSH）をコピーします。

  3. 該当する場合は、ローカルマシンのリポジトリを保存するディレクトリを選択します。

VS コードでノートブックを実行する

注釈

注意:このデプロイプロセスでは、SnowflakeCLI を使用します。

  1. ダウンロードしたレポを VSCode 環境で開きます。

  2. VS コードで、はい、作成者を信頼します をクリックします。

iaa_config.tomlファイル

パート1:「ツールをSnowflakeに接続する」から認証情報を取得する

  1. Snowflakeアカウントで、左下のイニシャルをクリックします。

  2. 「ツールをSnowflakeに接続する」を選択します。

  3. iaa\_config.toml ファイルを開きます。

  4. 「ツールをSnowflakeに接続する」ウィンドウから次の情報をコピーし、`iaa_config.toml` ファイルに貼り付けます。

    1. アカウント識別子

    2. ユーザー名

パート2: 追加の詳細を提供する

`iaa_config.toml` ファイルでは、次の情報も提供します。

  1. パスワード:Snowflakeのパスワードを入力してください。

  2. データベース名:IAA に使用するデータベース名を入力します。

  3. スキーマ名:IAA に使用したいスキーマの名前を入力します。

  4. ウェアハウス名:Snowflakeアカウントで稼働しているウェアハウスの名前を入力します。

変更を `iaa_config.toml` に保存します。

警告

警告：.toml情報が間違っていると、接続エントリを検証するセルが失敗する可能性があります。その場合は、入力情報を確認してください。

Kernel

.ipynbファイルを実行するには、VS コードにPythonおよびJupyterの拡張機能をインストールする必要があります。

  1. ノートブックの実行に必要なバージョンに準拠したpython環境を選択します。（3.11以降）

ノートブックを実行する

Snowflakeアカウントにアプリをデプロイするには、セルの「すべて実行」を選択します。

これらのセルは、自動的にローカル環境を設定し、Streamlitアプリのデプロイに備えてSnowflakeアカウントへの接続を確立します。具体的には、これらのセルはこうなります。

  1. Python3.11の要件を確認する

  2. Snowflake CLI 要件を確認する

  3. iaa_config.tomlファイルを実行し、Snowflakeアカウント構成に接続します。

    1. ローカルの.tomlファイルを読み取る

    2. 接続エントリを検証する

    3. Snowflakeへの接続を確立する

  4. SnowflakeでStreamlitアプリをデプロイする環境を準備する

    1. ローカル環境の設定

    2. 接続エントリを取得する

  5. Snowflake CLI を使用して、StreamlitアプリをSnowflakeにデプロイします。

    1. アプリスキーマを SiS にデプロイします。

    2. マップステージを SiS にデプロイします。

    3. APP をSiS にデプロイします。

    4. デプロイを更新する

    5. アプリ情報を取得し、アクセスボタンを提供します。

    \これで完了です。出力をアップロードする時が来ました。

あなたのSMA 出力をアップロードする時です！

出力フォルダーで「AssessmentFiles_*.zip」形式の名前の SMA 出力zipファイルを探します。

  1. Snowflakeアカウントに移動します

Data > Databases > [Your IAA Database] > Stages > SMA_EXECUTIONS
Copy

![あなたのSnowflakeアカウントのSMA_EXECUTIONS ステージ]（/images/migrations/sma-assets/explore_executions_upload_sma_output.png）

  1. _AssessmentFiles.zip._をアップロードします。

![SMA 出力を SMA_EXECUTIONS ステージにアップロードする]（/images/migrations/sma-assets/explore_executions_upload_assessmentFiles.png）

  1. IAA を開いて実行情報を調べます。このステップには約30秒かかります。

![IAA]（/images/migrations/sma-assets/explore_executions_open_iaa.png）

  1. IAA を開くと、ランディングページは次のようになります。

![IAA ランディングページ]（/images/migrations/sma-assets/iaa_landing.png）

これで、IAA を使って実行を調べることができます。

IAA を調査する

対話型評価アプリケーション（IAA）がSnowflakeアカウントにインストールされました。SMA の出力実行が正常にアップロードされ、SparkコードとSnowparkの互換性を確認する準備が整いました。

注釈

Snowflakeアカウントで IAA にアクセスする方法を覚えておいてください。

プロジェクト > Streamlit > 対話型評価アプリケーション

IAA を使用すると、コードのどの部分が直接互換性があり、どの部分に手動による介入やさらなる最適化が必要かを識別することができます。最新のSMA バージョンを使用することをお勧めします。ただし、古い実行がある場合、IAA はそれを最新の API マッピングバージョンと比較します。

言語: 日本語