Running the Tool
Using the Snowpark Migration Accelerator (SMA)
Last updated
Using the Snowpark Migration Accelerator (SMA)
Last updated
Now that the SMA is installed and the codebase is ready, it’s time to execute. If you still have the application open, head back over to it. If not, open the application.
When you launch the tool, if you see the Start/Activate page select "Start":
If you have ever used the SMA before, you likely will not see the above page. You may be taken immediately to the project page. If you do see the above page, choosing "Start" will take you to the project page:
Choose “New Project” in the menu. (If you have already started this walkthrough and previously created a project, you can open it by selecting “Open Project”.)
This will take you to the “Project Creation” page. Each execution of the SMA, whether you are doing an assessment or converting code, is tied to a “project” file that you create in this step. This project is a project file (with a .snowma extension) created in the source directory you previously chose on the project creation page. To tie multiple executions to a single project, you must open an existing project file. This is recorded both locally and in the shared database.
All fields here are essential for both the setup of the assessment tool and the project management that happens after you run the tool. The image below overviews each option:
For this walkthrough, use the “Spark Data Engineering Examples” codebase shared in the sample codebases section of this walkthrough. Once you've downloaded and unzipped the codebase, use the root directory that has all of the files as the input directory. Choose any name you'd like as the project name, and a suggested output directory will be populated in the output folder path. Change this to your desired output directory.
Before you start the assessment, recall the importance of ensuring the input directory has the correct codebase in the correct file type, as discussed in the previous step (code preparation).
When ready, select “SAVE & START ASSESSMENT” at the bottom right of the screen.
Once you start the assessment process, the SMA will begin analyzing the source code. It runs a basic code analyzer that does a lite scan of the code designed to inventory every file and every keyword detected in the codebase. It then parses the source code based on the source language and builds a semantic model representing what that code actually does. This model is then queried for the rest of the information (such as the Spark Reference Inventory and the Import Library Analysis) and will output the converted code in conversion mode.
This entire process is represented by a few progress markers (Loading Source Code, Analyzing Source Code, and Writing Results) that will illuminate on this screen:
When the analysis finishes, select “View Results” to evaluate the output.
