Snowpark Migration Accelerator: 評価の概要の理解¶

Spark API レディネススコア¶

このレポートにはいくつかのアイテムがありますが、中でも最も重要なメトリックは「レディネススコア」です。

各セクションを詳しく見ていきましょう。

1. レディネススコア - Spark API レディネススコア は、コードが移行に対してどの程度準備ができているかを評価するために SMA が使用する主なメトリックです。このスコアは、Spark API 参照のうち、Snowpark API に変換できるものの割合を示しています。このスコアは有用ですが、Spark API 参照のみを考慮し、サードパーティのライブラリやその他の要因は考慮していません。したがって、完全な評価ではなく、初期評価としてご利用ください。

   スコアは、変換可能なSpark API 参照の数を、コード内で見つかったSpark API 参照の合計数で割って計算されます。たとえば、スコアが3541/3746と表示された場合、3746の参照合計数のうち、3541の参照が変換可能であることを意味します。スコアが高いほど、Snowpark API との互換性が高いことを示します。このスコアは詳細レポートの最初のページに記載されています。

2. 次にすることの提案 - レディネススコアに基づき、 SMA は移行プロセスにおける次のステップを提案します。

3. レディネススコアの説明 - このセクションでは、Spark API レディネススコアの意味と、結果の解釈方法について詳しく説明します。

4. レディネススコアの内訳 - このセクションでは、2つの主要なメトリクスを使用してスコアがどのように計算されたかを示します。

   • 変換準備済みの使用: Snowparkに変換可能なSpark API 参照（関数、エレメント、またはインポートステートメント）の数。

   • 識別された使用: コード内で見つかったSpark API 参照の合計数。

サードパーティライブラリレディネススコア¶

サードパーティライブラリレディネススコアは、以下の形式で表示されます。

1. レディネススコア - レディネススコアとそのカテゴリ（緑、黄、赤）が表示されます。サードパーティライブラリレディネススコアは、インポートしたライブラリのうち、Snowflakeでサポートされているライブラリの割合を示します。詳細については、 サードパーティ API レディネススコア セクションをご参照ください。

2. 次のステップ - レディネススコアに基づいて、 SMA は次のアクションに関する推奨事項を提供します。

3. スコアの説明 - サードパーティライブラリレディネススコアの意味と結果の解釈方法について説明しています。

4. スコアの内訳 - サードパーティライブラリレディネススコアが、（Snowparkでサポートされているライブラリ呼び出しの数）÷（識別されたライブラリ呼び出しの合計数）という式を使用してどのように計算されたかを示します。

   条件:

   • 「Snowparkでサポートされるライブラリ呼び出し」とは、Snowparkが使用できるライブラリを意味します。

   • 「識別されたライブラリ呼び出し」とは、サポートされているかどうかにかかわらず、Sparkライブラリおよび非Sparkライブラリの両方を含む、コード内で検出されたすべてのサードパーティライブラリ呼び出しを意味します。

SQL レディネススコア¶

SQL レディネススコアは以下の形式で表示されます。

• レディネススコア - レディネススコアとそのカテゴリ（緑、黄、赤）が表示されます。このスコアは、Snowflake SQL に変換できたコード内の SQL 要素の数を示します。詳細については 、 SQL レディネススコア のセクションをご参照ください。

• 次のステップ - レディネススコアに基づいて、 SMA は、続行する前に実行する推奨アクションを提供します。

• スコアの説明 - SQL レディネススコアの明確な説明と結果の解釈方法を提供します。

• スコアの内訳 - SQL レディネススコアの詳細な計算が表示されます。計算は、（サポートされている要素の数）÷（要素の合計数）として計算されます。

Spark API 使用状況¶

レポートには3つの主要セクションがタブとして表示されます。

1. 全体の使用分類

2. Spark API 使用状況カテゴリ分類

3. ステータス別Spark API 使用状況

以下、各セクションについて詳しく見ていきましょう。

インポート呼び出し¶

「インポート呼び出し」セクションには、コードベースで頻繁に使用される外部ライブラリのインポートが表示されます。Spark API のインポートについては、「Spark API」のセクションで個別に説明されているため、このセクションからは除外されていることに注意してください。

このテーブルには以下の情報が含まれています。

レポートには以下の情報が表示されます。

1. 5行があるテーブルには以下が表示されます。

   • 最も頻繁にインポートされる3つのPythonライブラリ

   • 残りのパッケージをまとめた「Other」の行

   • すべてのインポートの合計を示す「Total」行

2. 各ライブラリがSnowflakeの Snowparkでサポートされているパッケージのリスト に含まれているかどうかを示す「Supported in Snowpark」列。

3. 「Import Count」列は、各ライブラリが全ファイルで何回インポートされたかを示します。

4. 各ライブラリのインポートを少なくとも1つ含むファイルの割合を示す「File Coverage」列。例:

   • 「sys」がインポートステートメントに29回登場し、28.16%のファイルでしか使用されていない場合、「sys」は通常、使用されるファイルごとに1回インポートされることを示唆しています。

   • 「Other」カテゴリでは、ファイルの100%で56件のインポートが発生している可能性があります。

ファイルごとの詳細なインポート情報については、 出力レポート の ImportUsagesInventory.csvファイルをご参照ください。

ファイルの概要¶

概要レポートには、ファイルタイプとサイズ別に整理されたメトリクスを表示する複数のテーブルが含まれています。これらのメトリクスは、コードベースの量に関する洞察を提供し、移行プロジェクトに必要な労力を見積もるのに役立ちます。

Snowpark Migration Acceleratorは、コードファイルと非コードファイルの両方を含む、ソースコードベースのすべてのファイルを分析します。スキャンされたファイルの詳細情報は、 files.csv レポートをご覧ください。

ファイルの概要には複数のセクションがあります。各セクションを詳しく見ていきましょう。

問題の概要¶

問題の概要は、コードスキャン中に見つかった潜在的な問題に関する重要な情報を提供します。評価から変換に移行すると、コードベースで検出された EWIs （エラー、警告、問題）のリストが表示されます。これらの問題の詳細については、ドキュメントの「問題の分析」セクションをご参照ください。

問題の概要の上部には、識別されたすべての問題の概要を示すテーブルがあります。

テーブルには2行あります。

• 「問題の数」は、各カテゴリで見つかったすべての問題コードの合計数を表します。

• 「一意の問題の数」は、各カテゴリで見つかったエラーコードの数を表しています。

問題は大きく3つのカテゴリに分けられます。

• 警告 は、ソースプラットフォームとターゲットプラットフォーム間の潜在的な差異を示し、直ちにアクションを起こす必要はないかもしれませんが、テスト中に考慮する必要があります。これには、エッジケースに対する動作のわずかな変化や、ソースプラットフォームと比較した外観の変更に関する通知などが含まれます。

• 変換の問題 は、変換に失敗した、またはターゲットプラットフォームで適切に動作するために追加構成が必要な要素を強調表示します。

• 解析の問題 は、ツールが特定のコード要素を解釈できない場合に発生します。これらは、早急な対応が必要な重大な問題であり、通常、ソースコードの非コンパイルや不正確なコード抽出が原因です。ソースコードが正しいと思われても改正エラーが発生する場合は、 SMA のパターンが認識されていない可能性があります。そのような場合は、 問題を報告 し、問題のあるソースコード部分を含めてください。

テーブルは各アイテムの合計数をまとめたものです。

このテーブルの下に、固有の問題コードとその説明のリストがあります。

各問題コードエントリは以下を提供します。

• 一意の問題識別子

• 問題の説明

• 発生回数

• 重大度レベル（警告、変換エラー、解析エラー）

問題コードをクリックすると、以下のような詳細ドキュメントを表示できます。

• 問題の包括的な説明

• コード例

• 推奨ソリューション

たとえば、上記の最初の問題コード（SPRKPY1002）をクリックすると、その問題専用のドキュメントページが表示されます。

デフォルトでは、上位5件のみが表示されます。すべての問題を表示するには、テーブルの下にある SHOW ALL ISSUES ボタンをクリックします。また、テーブルの上にある検索バーを使って特定の問題を検索することもできます。

評価モードでは、残りの変換作業を理解することが重要です。Reportsフォルダー 内の問題インベントリで、各問題の詳細情報とその場所を確認できます。

実行の概要¶

実行の概要は、ツールによる最近の分析の包括的な概要を提供します。説明には次が含まれます。

• コード分析スコア

• ユーザーの詳細

• 一意の実行 ID

• SMA とSnowpark API 両方のバージョン情報

• プロジェクト作成 時に指定したプロジェクトフォルダーの場所

付録¶

付録には、 SMA ツールが生成する出力をより理解するのに役立つ追加参照情報が含まれています。

このガイドには、Snowpark Migration Accelerator（SMA）の使用に関する一般的な参照情報が記載されています。コンテンツは定期的に更新される可能性がありますが、特定のコードベースに関する詳細ではなく、普遍的な SMA の使用に重点を置いています。

Snowpark Migration Accelerator（SMA）を実行すると、ほとんどのユーザーにこのような画面が表示されます。古いバージョンを使用している場合は、代わりに以下のような省略された評価の概要が表示される可能性があります。