Snowpark Migration Accelerator : Exécution de l’outil

Maintenant que vous avez installé l’outil Snowpark Migration Accelerator (SMA) et que vous avez préparé votre base de code, vous pouvez commencer le processus d’exécution. Retournez à l’application SMA si elle est encore ouverte ou lancez-la si vous l’avez fermée.

Configuration de projet

When you first open the SMA, the project page is shown.

Page du projet

Dans le menu, sélectionnez « Nouveau projet » pour commencer. Si vous avez déjà créé un projet pour ce guide, vous pouvez y accéder en sélectionnant « Ouvrir un projet ».

The « Project Creation » page allows you to create a new project file, which is essential for both assessment and code conversion tasks in SMA. The project file (with a .snowct extension) is stored in your selected output directory and keeps track of all your SMA executions. If you want to link multiple executions together, you can reopen an existing project file. All project information is saved both on your local machine and in the shared database. For more details about projects, see the « project » file.

All fields shown are required for configuring the assessment tool and managing the project after running the analysis.

Page de création du projet

  1. Project name: This is the name for your project file. Multiple executions can be connected to a single project as well as any settings you save. You can learn more about the project file below.

  2. Email address: This email address identifies the user of the tool. This should be the user of the tool, not the owner of the codebase being scanned.

  3. Company name: This is to help you specify the organization’s code you are working with. If you are running your own code, then put your own organization here. If you are working with another organization, then put that organization name here.

  4. Input folder: Specify the directory where your source codebase is located.

  5. Output folder: The directory where the output files (logs, reports, code) will be placed.

Pour ce guide, nous utiliserons la base de code « Exemples d’ingénierie des données Spark ». Vous la trouverez dans la section Exemples de bases de code. Suivez les étapes suivantes :

  1. Téléchargez et décompressez la base de code

  2. Rechercher le répertoire racine contenant tous les fichiers - ce sera votre répertoire d’entrée

  3. Choisissez le nom de projet que vous préférez

  4. Sélectionnez un répertoire de sortie (l’outil propose un emplacement par défaut, mais vous pouvez le modifier si nécessaire)

Avant de commencer l’évaluation, assurez-vous que votre répertoire d’entrée contient les fichiers de code source corrects avec les extensions de fichier adéquates, comme expliqué dans la section Préparation du code.

When you are ready to begin, click Save to save your project.

After you save, the SMA takes you to the project home page. Select the Code Process tile to start the guided assessment or conversion workflow:

Home Code Process Tile

In the Assessment Settings page, you’ll be prompted to choose whether to Skip Assessment or Start Assessment. Select Start Assessment, then click Continue to begin the assessment run:

Code Process Conversion Settings Start Assessment

Exécution et sortie de l’évaluation

Lorsque vous lancez le processus d’évaluation, SMA analyse votre code source en trois étapes :

  1. Tout d’abord, il effectue une analyse de base pour créer un inventaire de tous les fichiers et mots-clés de votre base de code.

  2. Ensuite, il analyse le code en fonction de votre langue source et crée un modèle sémantique qui représente la fonctionnalité du code.

  3. Finally, it uses this model to generate detailed information, including the Spark Reference Inventory and Import Library Analysis. It also produces the converted code.

Au cours de ce processus, trois indicateurs de progression s’affichent à l’écran :

  • Chargement du code source

  • Analyse du code source

  • Écriture des résultats

Ces indicateurs s’allument au fur et à mesure de l’exécution de chaque étape.

Page Exécution

After the analysis is complete, the SMA automatically shows the Assessment Results page where you can see the analysis output.