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

Démarrer ou Activer

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 :

Page du projet de l'outil

Sur cette page, vous trouverez trois options disponibles :

Création d’un nouveau projet

En cliquant sur le bouton « Nouveau projet », vous ouvrez l’écran de création de projet.

Page de création du projet

La page de création de projet contient plusieurs champs que vous devez remplir.

  1. 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.

  2. 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.

Menu déroulant des sous-dossiers

  • 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.

  1. 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).

  2. SQL Langage : Sélectionnez SparkSQL ou HiveSQL en fonction de votre code source. (En option)

  3. 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.

  4. 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

Prochaines étapes de création du projet

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.

Fichier de projet .snowma

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.

Page du projet

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.

Projets récemment ouverts

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é.

Panneau de navigation

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.