Readiness Scores
How ready is your codebase for Snowpark? There's more than one way to tell.
The Snowpark Migration Accelerator (SMA) generates a large amount of assessment information when it is executed. To help interpret this, the SMA generates a series of scores designed to help understand how ready a workload is for migration. These Readiness Scores are simple metrics designed to show the user how "ready" a codebase is for Snowflake. Think of this as a compatibility metric. The higher the Readiness Score, the more compatible this codebase is with Snowflake by only running the SMA.
The following Readiness Scores are currently being output by the SMA:
It should be noted that the Readiness Scores are not effort estimates. A high readiness scores does not mean that the manual work remaining is small. It simply means that based on that measure of readiness, the majority of the codebase is already compatible with Snowflake. It does not mean that what is not compatible will not require much effort. Use the full output of the assessment to help determine how much effort is required to complete a migration. Feel free to reach out to us if you would like more support on building a migration plan and effort estimate.
Levels
The Snowpark Migration Accelerator (SMA) has Each score reports a red, yellow, or green status. Think of these scores as a stoplight. For each color:
Red - Stop and solve. There is an issue that has a significant impact on the migration or the tool’s ability to report on this codebase. Stop at this score, read the action steps, and act immediately to resolve.
Yellow - Proceed with caution. There is an issue that might have a significant impact on the migration. Read the action steps, ensure you fully understand the impact of the yellow result, and move on to the next score when ready.
Green - Keep going. The tool did not detect a significant blocker for the migration of this codebase. This does not mean that the code is immediately ready to migrate. Read the action steps and proceed.
How to Interpret the Scores
Each score will give you a number, a red/yellow/green status (described above), and a suggestion on what to do next. It is strongly advised to:
Go through the scores in order - once you hit a red score, attempt to understand that problem immediately
Read all of the suggested next steps for each score - regardless of the result (even the green results), that’s where you’ll find action items.
Let's take a closer look at each of the readiness scores that are available today.
Spark API Readiness Score
The Spark API Readiness Score is the primary indicator of readiness that the Snowpark Migration Accelerator produces. However, this readiness is based only on references to the Spark API, not on any other factors or third-party libraries that may be present in the codebase.
When the SMA runs, it will identify all references to the Spark API. This could be import usages or functions. They are logged in the Spark API Usages Inventory available in the local output. Each reference depending on how it is used in the codebase is logged as either supported or not supported based on the Spark Reference Categories used by the tool. To calculate this readiness score, the tool takes all of the supported refernces and divides by the total references found in the codebase:
This result will show as a percentage. The higher the number, the more references to the Spark API are supported in Snowflake. You can find this score in both the output detailed report and the assessment summary in the application.
Note that this is the original Readiness Score that was produced by the SMA. In versions of the SMA where only a single Readiness Score is produced, that Readiness Score is actually the Spark API Readiness Score.
Spark API Readiness Levels
Depending on the result of the above calculation, the score can be categorized as green, yellow, or red. In the applicaiton and the output report, you will see the corresponding guidance issued based on the calculated result.
For the Spark API Readiness Score, one of the following levels will be produced:
Green - The majority of references to the Spark API are supported. This indicates a workload that is a good candidate for a migration. If the other indicators are green, it might be time to run a quick Proof of Concept.
Yellow - There are enough references that are not supported to indicate some significant effort to migrate this workload. The next step would be to inventory the items that are not supported, and determine the effort required to convert those.
Red - There are a significant number of not-supported references. This workload may not be the best candidate for migration. A good next step would be to inventory the elements that are not supported, and determine if there is a common thread. If there are elements that may require significant rearchitecture, include that planning as part of the migration process. If you need help, feel free to reach out to sma-support@snowflake.com.
As with all readiness scores, only looking at a single one to determine the overall readiness of this workload can be misleading. There are other factors that you will want to take into account when migrating. The readiness scores should be used as a starting point. If there is a measure of readiness that you think is not well reported by the tool, let us know! The SMA team is constantly improving the readiness metrics available.
Last updated
