Snowpark Migration Accelerator: ツールの実行

Snowpark Migration Accelerator(SMA)をインストールし、コードベースを準備すると、実行プロセスを開始できます。SMA アプリケーションが開いている場合は戻り、閉じている場合は起動します。

プロジェクト設定

When you first open the SMA, the project page is shown.

プロジェクトページ

メニューから「新規プロジェクト」を選択して開始します。このチュートリアルのためにすでにプロジェクトを作成している場合は、代わりに「プロジェクトを開く」を選択することでアクセスできます。

The "Project Creation" page allows you to create a new project file, which is essential for both assessment and code conversion tasks in SMA. The project file (with a .snowct extension) is stored in your selected output directory and keeps track of all your SMA executions. If you want to link multiple executions together, you can reopen an existing project file. All project information is saved both on your local machine and in the shared database. For more details about projects, see the "project" file.

All fields shown are required for configuring the assessment tool and managing the project after running the analysis.

プロジェクト作成ページ

  1. Project name: This is the name for your project file. Multiple executions can be connected to a single project as well as any settings you save. You can learn more about the project file below.

  2. Email address: This email address identifies the user of the tool. This should be the user of the tool, not the owner of the codebase being scanned.

  3. Company name: This is to help you specify the organization's code you are working with. If you are running your own code, then put your own organization here. If you are working with another organization, then put that organization name here.

  4. Input folder: Specify the directory where your source codebase is located.

  5. Output folder: The directory where the output files (logs, reports, code) will be placed.

このウォークスルーでは、「Sparkデータエンジニアリング例」コードベースを使用します。これは、 サンプルコードベースセクション にあります。以下のステップを実行します。

  1. コードベースをダウンロードして解凍します。

  2. すべてのファイルが格納されているルートディレクトリを探します。これが、入力ディレクトリになります。

  3. ご希望のプロジェクト名を選択します。

  4. 出力ディレクトリを選択します(ツールはデフォルトの場所を提案しますが、必要に応じて変更できます)。

評価を開始する前に、 コード準備 セクションで説明されているように、入力ディレクトリに適切な拡張子のソースコードファイルがあることを確認してください。

When you are ready to begin, click Save to save your project.

After you save, the SMA takes you to the project home page. Select the Code Process tile to start the guided assessment or conversion workflow:

Home Code Process Tile

In the Assessment Settings page, you’ll be prompted to choose whether to Skip Assessment or Start Assessment. Select Start Assessment, then click Continue to begin the assessment run:

Code Process Conversion Settings Start Assessment

実行と評価の出力

評価プロセスを開始すると、 SMA は、3つのステップでソースコードを分析します。

  1. まず、基本的なスキャンを実行し、コードベース内のすべてのファイルとキーワードのインベントリを作成します。

  2. そして、ソース言語に従ってコードを解析し、コードの関数を表すセマンティックモデルを作成します。

  3. Finally, it uses this model to generate detailed information, including the Spark Reference Inventory and Import Library Analysis. It also produces the converted code.

このプロセス中、画面には3つの進行状況インジケーターが表示されます。

  • ソースコードの読み込み

  • ソースコードの分析

  • 結果の書き込み

各ステップが完了すると、これらのインジケーターが点灯します。

実行ページ.

After the analysis is complete, the SMA automatically shows the Assessment Results page where you can see the analysis output.