Snowpark Migration Accelerator: SMA CLI ウォークスルー

The Snowpark Migration Accelerator (SMA) helps developers migrate their Python or Scala Spark code to Snowpark. It analyzes your code and:

  1. Snowparkとの互換性を評価します

  2. 互換性のあるSpark API 呼び出しを自動的にSnowpark API に変換します

  3. 自動変換できないコードを識別します

  4. スクリプトやノートブックからサードパーティライブラリインポートのインベントリを作成します。

  5. SparkとSnowparkのコードを比較した編集可能な互換性レポートを生成します

Snowflakeは、Snowpark Migration Accelerator（SMA）用のコマンドラインインターフェイス（CLI）をリリースしています。このガイドでは、 CLI をスタンドアロンのツールとして使用する方法と、スクリプト内で使用する方法の両方を説明します。

CLI の使用

You can download the Command Line Interface (CLI) from the Download and Access section. Select the version that matches your operating system. You can store the CLI in any accessible location on your machine or container.

注釈

NOTE: このウォークスルーでは、Macコンピューターのスクリーンショットを使用していますが、WindowsやLinuxユーザーでのプロセスも同様です。

パッケージファイル（.zipまたは.tar形式）をダウンロードしたら、中身を解凍します。コマンドラインインターフェイス（CLI）ツールは、解凍したファイル内の「orchestrator」フォルダーにあります。

Orchestratorディレクトリ内の SMA CLI

インストールフォルダーでターミナルまたはコマンドプロンプトを開き、以下のコマンドを実行して CLI のインストールを検証し、バージョンを検証します。

./sma --version

このような結果が表示されます。

SMA バージョン情報

The SMA Command Line Interface (CLI) is a local application that runs on your computer, similar to the SMA desktop application. To analyze your code files using the SMA CLI, these files must be stored on your local machine where the CLI can access them. The CLI supports the same file types as the regular SMA application. For a complete list of supported file types, refer to the supported filetypes in the SMA documentation.

注釈

NOTE: To test the CLI functionality, you can use the sample codebase provided in the Assessment section or refer to the Conversion walkthroughs in the SMA documentation.

SMA ドキュメントには、 CLI 引数の包括的なリストがあります。このセクションでは、最も重要なものを探ってみましょう。

The SMA CLI runs in Conversion mode by default, rather than Assessment mode. To run the CLI in assessment mode, use the -a argument. For conversion operations, you'll need a valid access code. To verify if you have a valid access code, use the following command:

./sma show-ac
ライセンス情報

変換を実行するには、以下が必要です。

  1. 入力ディレクトリ（必須）

  2. 出力ディレクトリ（必須）

プロジェクトファイルを作成したことがない場合は、以下も必要です。

  • ユーザーメールアドレス

  • 組織名

  • プロジェクト名

一度これらのパラメーターをセットアップしてしまえば、次回以降は入力と出力のディレクトリを指定するだけで変換できます。

./sma -i '/your/INput/directory/path/here' -o '/your/OUTput/directory/path/here' -e your@email.com -c Your-Organization -p Your-Project-Name

この画面では実行設定の概要が表示され、続行するかどうかの確認が求められます。

プロジェクト情報セクション

確認プロンプトをスキップするには、--yesまたは-yパラメーターを追加します。これは、自動化スクリプトから CLI を実行する場合に特に重要です。

ツールは実行中に詳細な進捗情報を提供します。

出力されたプロジェクト情報

While the tool is running, it will continuously print output to the screen. When the process is complete, you will see the prompt again. The tool generates detailed output that includes all processes, issues, and completed or failed steps. You don't need to read through all of this information while it's running, as you can review it later in the Logs output folder.

出力の表示

SMA CLI は SMA アプリケーションと同じ出力を生成します。ツールを実行すると、指定した出力ディレクトリに3つのフォルダーが作成されます。

  • Reports

  • Logs

  • 出力（変換されたコードを含む）

SMA からの出力ディレクトリ

For detailed guidance on working with code that has been converted by the Snowpark Migration Accelerator (SMA), refer to the conversion walkthrough.

プログラムによる CLI の実行

近日公開予定です。SMA チームは、 SMA コマンドラインインターフェイス（CLI）を複数のディレクトリで自動的に実行できるスクリプトを提供します。

Try out the Command Line Interface (CLI) today. If you need help or have questions, contact the Snowpark Migration Accelerator team at sma-support@snowflake.com.