Snowpark Migration Accelerator : Configuration de projet¶
Lorsque vous ouvrez pour la première fois l’outil Snowpark Migration Accelerator (SMA), vous voyez deux options :
Démarrer : Commencez à travailler sur un nouveau projet
Activer : Saisissez un code d’accès pour utiliser les fonctions de conversion uniquement
Page de démarrage¶
La section suivante explique chaque option disponible :
Démarrer - Ouvre la page du projet où vous pouvez créer un nouveau projet, ouvrir un projet existant ou explorer un exemple de projet.
Activer - Ouvre la page d’activation où vous pouvez saisir ou demander un code d’accès si vous ou votre organisation êtes éligible.
Note
Si vous avez déjà saisi un code d’accès, ignorez cet écran et vous serez dirigé vers la page du projet.
Page du projet¶
Sur la page du projet, vous trouverez les trois options suivantes :
Sur cette page, vous trouverez trois options disponibles :
Ouvrir le projet - Parcourez et sélectionnez un fichier de projet précédemment créé. Pour plus d’informations sur l’ouverture d’un projet existant, consultez la section Plus d’informations sur l’ouverture d’un projet existant.
Nouveau projet - Sélectionnez cette option pour créer un nouveau projet. En savoir plus sur la création d’un nouveau projet.
Voir l’exemple de projet - Testez un exemple de projet pour vous familiariser avec SMA. Pour obtenir des instructions étape par étape, consultez le guide Exécution de l’exemple de projet.
Création d’un nouveau projet¶
En cliquant sur le bouton « Nouveau projet », vous ouvrez l’écran de création de projet.
La page de création de projet contient plusieurs champs que vous devez remplir.
Nom du projet : Saisissez un nom pour votre projet. Ce nom sera utilisé pour mémoriser vos paramètres et suivre les exécutions multiples. Vous trouverez ci-dessous plus de détails sur les fichiers de projet.
Chemin du dossier d’entrée : Sélectionnez le dossier contenant votre code source. Notez que SMA n’analysera que les types de fichiers pris en charge. Vous pouvez :
Choisissez un sous-dossier ou un fichier spécifique à l’aide des cases d’option situées à côté des noms de dossiers.
Analysez une partie seulement de votre base de code en sélectionnant un sous-répertoire spécifique.
Remarque : Lorsque vous survolez une étiquette de chemin, une info-bulle affiche le chemin complet. Cela s’applique à tous les champs contenant des chemins raccourcis (chemin du dossier d’entrée, chemin du dossier de sortie, etc.)
Le fichier de projet .snowma est créé dans ce répertoire lorsque vous créez le projet. Voir ci-dessous pour plus de détails sur ce dossier.
Chemin du dossier de sortie : Sélectionnez le répertoire dans lequel SMA stockera les fichiers de sortie, y compris les journaux, les rapports et le code converti (en mode conversion).
SQL Langage : Sélectionnez SparkSQL ou HiveSQL en fonction de votre code source. (En option)
Adresse e-mail : Saisissez votre adresse e-mail pour vous identifier en tant qu’utilisateur de l’outil. Snowflake n’utilisera cet e-mail que pour vous envoyer le rapport de qualification Snowpark et votre code d’accès à la conversion si vous passez en mode conversion.
Société du client : Saisissez le nom de l’organisation dont vous utilisez le code. Si vous analysez votre propre code, saisissez le nom de votre organisation. Si vous travaillez avec le code d’une autre organisation, indiquez son nom. Cela permet d’organiser les projets par organisation.
Tous les champs doivent être remplis pour que l’outil puisse fonctionner.
Après avoir configuré votre projet, trois options s’offrent à vous :
Cliquer sur « Enregistrer et commencer l’évaluation » pour enregistrer votre projet et commencer le processus d’évaluation
Cliquer sur « Enregistrer et ignorer l’évaluation » pour enregistrer votre projet sans effectuer d’évaluation
Cliquer sur « Annuler » pour quitter sans enregistrer
Avant d’entamer le processus de conversion, vous devez décider s’il convient de procéder à une évaluation. Nous vous recommandons de commencer par l’évaluation, sauf si vous êtes certain de vouloir passer directement à la conversion. Si vous avez des doutes, il est préférable de commencer par la phase d’évaluation.
En cliquant sur « Annuler », vous revenez à l’écran principal. Si vous choisissez « Démarrer » ou « Ignorer », les paramètres de votre projet seront enregistrés dans un fichier .snowma. Ce fichier vous permet de rouvrir le projet ultérieurement en conservant tous les paramètres configurés.
Remarques sur le fichier de projet SMA (.snowma)¶
Le fichier .snowma est un fichier de configuration de projet qui stocke les paramètres de votre projet et l’historique des évaluations. Ce fichier vous permet :
De relancer l’outil en utilisant les mêmes paramètres de configuration
D’accéder et de vérifier les données d’évaluation des exécutions précédentes
Chaque fois que vous cliquez sur « Enregistrer et ignorer l’évaluation » ou « Enregistrer et commencer l’évaluation », SMA crée un fichier de projet (avec une extension .snowma) dans le dossier d’entrée que vous avez sélectionné. Ce fichier de projet, marqué de l’icône SMA, contient le code source que vous souhaitez convertir.
En tant qu’utilisateur, vous disposez des fonctionnalités suivantes :
Double-cliquez sur le fichier .snowma pour ouvrir un projet existant.
Cliquez sur « Ouvrir un projet » dans l’écran principal pour ouvrir un projet existant.
Affichage des projets récemment ouverts : Pour afficher une liste de vos projets récemment ouverts dans SMA, cliquez sur Fichier > Projets récemment ouverts dans la barre de menu.
Lorsque vous reprenez l’un de ces flux de travail, l’outil vous ramène au point où vous vous étiez arrêté lors de la session précédente.
Ouvrir un projet¶
Dans l’écran principal, cliquez sur Ouvrir un projet pour lancer votre navigateur de fichiers. Sélectionnez un fichier de projet avec une extension .snowma pour ouvrir la page de création de projet. Cette action fonctionne quel que soit le statut d’achèvement de votre projet.
Le panneau de navigation de la page Création de projet vous permet de revenir aux écrans auxquels vous avez accédé.
Après avoir renseigné les détails de votre projet, cliquez sur « Enregistrer et commencer l’évaluation » pour lancer l’outil.
La section suivante explique les options de configuration et les paramètres disponibles lors de l’utilisation de l’application.