Assessment Quick Start

Running an assessment using the Snowpark Migration Accelerator

The Snowpark Migration Accelerator (SMA) allows you to run a code assessment that will generate a set of reports and inventories about your source code. Here's how to get started quickly.

How to Execute an Assessment

To execute an assessment for your code you will start by creating a new Snowpark Migration Accelerator project.

Start by clicking on the New Project button.
After you complete the project information, the Save & Start Assessment button will be enabled.
The progress screen will appear next and inform you about the execution status. When the assessment is finished, click View Results to move on to the next screen.
The results screen will have a lot of information designed to help you understand what you have and what can be migrated to Snowpark. Review the section on Understanding the Assessment Summary to walkthrough this output.

Note that there is some information in this assessment summary page (shown above), but there is considerably more in the full output folder including a multi-page detailed report.

Next Steps

There ends the work that the tool has done. Now it's your turn to interpret the results and decide on the next steps. Here's a few quick tips:

Use the Readiness Score as a starting point - The readiness score is based solely on references to the Spark API. However, there are other factors that affect whether a codebase can be migrated such as the presence of unsupported third party libraries and your particular use case (is this workload the best fit for Snowpark?).
Don't skip straight to conversion - The assessment information is rich. Try to develop a plan for how to best migrate the codebase/use-case that you have. If you skip any analysis of the assessment information and go straight into the conversion, you will likely end up duplicating effort.

Retry Assessment - After you execute an assessment, on the Assessment Results page you can select the Retry Assessment button to run the assessment again. After examining the output, it is not uncommon to make some changes in the source code and run the assessment again.
View Log Folder: This will take you to the log folder. This folder is created when you run the assessment and a complete set of logs made up of several text files that describe the status of the execution will be deposited here. You can view the logs in any text editor. The logs will be most valuable when it's necessary to troubleshoot through an execution that failed. If there was a failure, the tool may ask you to send the logs. The logs in this folder is what will be sent.
View Reports: This will take you to the reports folder. Like the logs folder, this one is created when you run the assessment. The reports folder contains the output of the assessment including the detailed report, spark reference inventory, and other inventories built from the source codebase. Each report is detailed in this documentation.
Continue to Conversion: Conversion may seem like the logical next step, but before you move on to conversion, make sure you've reviewed the assessment output. To run a conversion, you will need an access code. You can learn more about this in the conversion section of this documentation.

A longer look at the information in the assessment summary is next, but if you are ready for conversion, you can check out the conversion quick start.

PreviousHow the Assessment Works NextUnderstanding the Assessment Summary

Last updated 4 months ago

How to Execute an Assessment

To execute an assessment for your code you will start by creating a new Snowpark Migration Accelerator project.

Start by clicking on the New Project button.

After you complete the project information, the Save & Start Assessment button will be enabled.

The progress screen will appear next and inform you about the execution status. When the assessment is finished, click View Results to move on to the next screen.

The results screen will have a lot of information designed to help you understand what you have and what can be migrated to Snowpark. Review the section on Understanding the Assessment Summary to walkthrough this output.

Note that there is some information in this assessment summary page (shown above), but there is considerably more in the full output folder including a multi-page detailed report.

Next Steps

There ends the work that the tool has done. Now it's your turn to interpret the results and decide on the next steps. Here's a few quick tips:

Use the Readiness Score as a starting point - The readiness score is based solely on references to the Spark API. However, there are other factors that affect whether a codebase can be migrated such as the presence of unsupported third party libraries and your particular use case (is this workload the best fit for Snowpark?).

Don't skip straight to conversion - The assessment information is rich. Try to develop a plan for how to best migrate the codebase/use-case that you have. If you skip any analysis of the assessment information and go straight into the conversion, you will likely end up duplicating effort.

There are some additional options available in the application as well.

Retry Assessment - After you execute an assessment, on the Assessment Results page you can select the Retry Assessment button to run the assessment again. After examining the output, it is not uncommon to make some changes in the source code and run the assessment again.

View Log Folder: This will take you to the log folder. This folder is created when you run the assessment and a complete set of logs made up of several text files that describe the status of the execution will be deposited here. You can view the logs in any text editor. The logs will be most valuable when it's necessary to troubleshoot through an execution that failed. If there was a failure, the tool may ask you to send the logs. The logs in this folder is what will be sent.

View Reports: This will take you to the reports folder. Like the logs folder, this one is created when you run the assessment. The reports folder contains the output of the assessment including the detailed report, spark reference inventory, and other inventories built from the source codebase. Each report is detailed in this documentation.

Continue to Conversion: Conversion may seem like the logical next step, but before you move on to conversion, make sure you've reviewed the assessment output. To run a conversion, you will need an access code. You can learn more about this in the conversion section of this documentation.

A longer look at the information in the assessment summary is next, but if you are ready for conversion, you can check out the conversion quick start.