Snowpark Migration Accelerator: 変換設定¶
最初にSnowpark Migration Accelerator（SMA）を起動する際に、新しいプロジェクトを作成するか、既存のプロジェクトを開く必要があります。各プロジェクトは、評価と変換の両フェーズについて、 SMA の実行を複数保存できます。評価フェーズが完了したら、変換フェーズ用にプロジェクトを構成する必要があります。
変換設定ページ¶
変換処理中、いくつかの構成オプションが利用可能ですが、ほとんどの場合、デフォルト設定でうまくいくはずです。
入力フォルダーパス - 分析するコードファイルがあるディレクトリです。このパスは プロジェクト作成 の際に指定したものと同じにすることもできますが、別のディレクトリを選択することもできます。SMA は、最初の評価以降にコードが変更された場合でも、正確な変換結果を保証するために新しい評価を実行します。
注釈
ツールは特定のファイル拡張子のみを分析します。
フォルダー名の横にあるラジオボタンを使用して、特定のサブフォルダーまたは個々のファイルを選択できます。
このプロセスの一環として、評価報告書が再度作成されます。
注釈
When you hover your mouse over any path label in the interface, a tooltip will display the complete file path. This feature works for all fields containing shortened paths, such as input and output folder locations.
出力フォルダーパス - SMA がログ、レポート、変換されたコードを含むすべての生成ファイルを保存する保存先フォルダーを選択します。
アクセスコードを入力 - このフィールドにアクセスコードを入力します。アクセスコードをお持ちでない方はリクエストできます。アクセスコードの取得方法については、次のセクションで説明します。
Select Change Conversion Settings to change settings that govern details of the conversion. For more information, see Conversion settings.
アクセスコードの入力とリクエスト¶
Snowpark Migration Accelerator（SMA）を使用して変換を実行するには、アクセスコードが必要です。これらのコードは通常、個々のユーザーまたはメールアドレスにリンクされ、どの SMA 機能を使用できるかを決定します。アクセスコードがなくても評価を実行することができます。アクセスコードの入力が求められるのは、変換セットアップステージに移動したときのみです。
アクセスコードのリクエスト¶
アクセスコードはいつでも ヘルプメニューを介して リクエストできます。または、変換セットアップページで アクセスコードについて問い合わせる をクリックすることもできます。
アクセスコードのリクエストフォームが表示されます。
アクセスコードの入力¶
アクセスコードをリクエストすると、フォームに入力されたメールアドレスにアクセスコードが送信されます。メールは sma-notifications@snowflake.com から届きます。アクセスコードは、 SMA インターフェイスには自動的に表示されません。メールを確認して取得する必要があります。
メールに記載されているアクセスコードをコピーし、変換セットアップの「新しいアクセスコードを入力または選択」フィールドに貼り付けます。アクセスコードはアルファベット、ダッシュ、数字で構成されており、メールに記載されているとおりに入力する必要があります。
アクセスコード検証のための重要情報:
アクセスコードを入力する際は、「Enter」（または「Return」）キーを押してアクティブ化します。コードを貼り付けるだけでは不十分で、「Enter」を押す必要があります。ツールは、アクセスコードが正常にアクティブ化されたか、失敗したかを示すメッセージを表示します。メッセージが表示されない場合は、アクセスコードフィールドをクリックし、もう一度「Enter」キーを押します。
SMA は、インターネット接続を必要とする SMA アクセス API を通じてアクセスコードを検証します。インターネットアクセスがないと、コード検証や変換機能が動作しません。API ネットワークセキュリティ上、アクセスコードをホワイトリストに登録する必要がある場合は、 sma-support@snowflake.com までご連絡ください。
ライセンスの検証後、 SMA にアクセスコードの詳細が表示されます。これには、上の画像のように、有効期限と関連するメールアドレスが含まれます。
Snowpark Migration Accelerator（SMA）のアクセスコードを取得するには、このドキュメントのアクセスセクションをご参照ください。
セットアップ完了¶
変換設定を構成した後、アプリケーションの下部にある 変換を開始 をクリックします。このアクションにより、 SMA 評価と変換プロセスの両方が開始されます。ステータス画面が表示されますが、これは評価フェーズ 中に表示されるものと同じです。
結果を表示 をクリックして、変換出力画面に進みます。
Conversion Settings¶
With the following settings from the user interface, you can more finely control how the SMA performs conversion.
Pandas
Convert Pandas API to Snowpark API - Specifies to automatically convert Pandas code to the Snowpark equivalent Pandas API (Snowpark Pandas). When enabled, the tool transforms any Pandas operations it finds in your code into their Snowpark counterparts.
DBX
Convert DBX notebooks to Snowflake notebooks - Specifies to convert the .dbc into Jupyter files in a new folder with the .dbc name.
注釈
When exporting notebooks, consider exporting them as Databricks, rather than Jupyter. When Jupyter files contain different sources than Python, SMA behavior may be unexpected.
Checkpoints
Identify and collect checkpoints - Activates the feature.
Collect checkpoints as active - Specifies to execute the collected checkpoint in VS Code when running the workload.
Collect user-defined functions returning data frame type - Specifies to validate that dataframes should be collected if the user has their own functions that return DataFrames.
Mode - Specifies the mode type to validate (Schema or DataFrame).
Sample - Specifies the sampling percentage of each DataFrame to validate.
Relevant PySpark functions to collect - Specifies the PySpark packages to collect (by default, all of them are checked). You can also add more packages by adding the package’s full name.