Snowpark Migration Accelerator : Guide de la CLI SMA

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

  1. Évalue la compatibilité avec Snowpark

  2. Convertit automatiquement les appels Spark API compatibles en Snowpark API

  3. Identifie le code qui ne peut pas être converti automatiquement

  4. Crée un inventaire des importations de bibliothèques tierces à partir de scripts et de notebooks

  5. Génère un rapport de compatibilité modifiable qui compare le code Spark et le code Snowpark

Snowflake a publié une interface de ligne de commande (CLI) pour Snowpark Migration Accelerator (SMA). Ce guide vous montrera comment utiliser la CLI en tant qu’outil autonome et dans un script.

Utilisation de l’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

NOTE : Bien que ce guide utilise des captures d’écran d’un ordinateur Mac, le processus est similaire pour les utilisateurs de Windows et de Linux.

Après avoir téléchargé le fichier de paquet (format .zip ou .tar), extrayez son contenu. L’outil CLI se trouve dans le dossier « orchestrator » dans les fichiers extraits.

SMA CLI dans le répertoire Orchestrator

Ouvrez un terminal ou une invite de commande dans le dossier d’installation et vérifiez l’installation de CLI en exécutant la commande suivante pour vérifier sa version :

./sma –version

Vous obtiendrez les résultats suivants :

Informations sur la 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

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.

La documentation SMA contient une liste complète d’arguments CLI. Dans cette section, nous allons examiner les plus importants d’entre eux.

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
Informations sur la licence

Pour effectuer une conversion, vous devez fournir les éléments suivants :

  1. Répertoire d’entrée (requis)

  2. Répertoire de sortie (requis)

Si vous n’avez encore jamais créé de fichier de projet, vous devrez également fournir les informations suivantes :

  • E-mail de l’utilisateur

  • Nom de l’organisation

  • Nom du projet

Une fois l’ensemble de ces paramètres définis pour la première fois, il vous suffit de spécifier les répertoires d’entrée et de sortie pour les conversions ultérieures.

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

Cet écran affiche un résumé de vos paramètres d’exécution et vous invite à confirmer si vous souhaitez poursuivre.

Section Information sur le projet

Pour ignorer la demande de confirmation, ajoutez le paramètre –yes ou -y. Ceci est particulièrement important lorsque vous exécutez la CLI à partir de scripts automatisés.

L’outil fournit des informations détaillées sur l’avancement de l’exécution.

Impression des informations sur le projet

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.

Affichage de la sortie

La CLI SMA génère la même sortie que l’application SMA. Lorsque vous exécutez l’outil, il crée trois dossiers dans le répertoire de sortie que vous avez spécifié :

Répertoire de sortie de l'outil SMA

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

Exécution de la CLI par programmation

Bientôt disponible ! L’équipe SMA fournira un script qui vous permettra d’exécuter automatiquement l’interface de ligne de commande (CLI) SMA dans plusieurs répertoires.

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.