Snowpark Migration Accelerator : Guide d’installation de l’application d’évaluation interactive

Cette section vous guide dans le déploiement de l’application d’évaluation interactive (IAA) dans votre compte Snowflake. LIAA est une application Streamlit qui exploite la puissance de Snowflake au sein de Snowflake pour analyser les données de sortie de Snowpark Migration Accelerator (SMA). Ce document fournit les étapes et les ressources nécessaires pour analyser votre charge de travail dans votre environnement Snowflake à l’aide de l’IAA.

Guide progressif

Avant de déployer l’IAA, assurez-vous de respecter les conditions préalables suivantes :

  • Vous avez exécuté l’outil SMA. Les données de sortie sont prêtes pour l’analyse.

  • Vous possédez un compte Snowflake. (Il est nécessaire pour héberger et exécuter l’IAA.) Si ce n’est pas le cas, un Compte d’essai Snowflake fonctionnera.

  • Vous avez VSCode ou Jupyter installé pour exécuter le notebook : VSCode ou Jupyter.

  • Vérifiez que vous avez Python 3.11 ou une version ultérieure installée. Cette version est nécessaire pour la compatibilité avec le notebook IAA.

    • Python est peut-être déjà installé sur votre système. Si ce n’est pas le cas, suivez l’une des options ci-dessous.#x20;

Le chargement de toutes les tables de mappages peut prendre plus de temps que la sélection des dernières. Nous vous recommandons de télécharger les dernières versions si vous ne souhaitez pas comparer votre exécution avec les versions précédentes.

Dans VS Code, vous pouvez sélectionner le dossier Map, qui contient tous les dossiers avec les versions des APIs et des EWIs et supprimer celles que vous ne souhaitez pas télécharger. Dans ce cas vous pouvez conserver uniquement la version 7.1.2.

Mappages disponibles pour le chargement

Une fois que vous avez terminé de vérifier les conditions préalables, passez au déploiement.

Déployons l’IAA !

Note

Ce guide étape par étape s’applique à VS Code

Référentiel

  1. Accédez au GitHub en open source de Snowflake Labs : https://github.com/Snowflake-Labs/IAA-Support.

  2. Cliquez sur le bouton « Code », et copiez votre méthode préférée pour cloner le référentiel (par exemple, HTTPS ou SSH)#20;

  3. Choisissez le répertoire dans lequel vous souhaitez enregistrer le référentiel sur votre machine locale, le cas échéant.

Exécution du notebook dans VS Code

Note

Remarque : Ce processus de déploiement utilise Snowflake CLI.#x20;

  1. Ouvrez le référentiel téléchargé dans l’environnement VSCode.

  2. Dans VS Code, cliquez sur Oui, je fait confiance aux auteurs

Fichier iaa_config.toml

Partie 1 : Obtention des identifiants de connexion depuis « Connecter un outil à Snowflake »

  1. Dans votre compte Snowflake, cliquez sur vos initiales dans le coin inférieur gauche.

  2. Sélectionnez « Connecter un outil à Snowflake ».

  3. Ouvrez le fichier iaa\_config.toml.

  4. Copiez les informations suivantes de la fenêtre « Connecter un outil à Snowflake » et collez-les dans la fichier `iaa_config.toml` :

    1. Identificateur du compte

    2. Nom d’utilisateur

Partie 2 : fournir des détails supplémentaires

Dans le fichier `iaa_config.toml`, fournissez également les informations suivantes :

  1. Mot de passe : Saisissez votre mot de passe Snowflake.

  2. Nom de la base de données : Saisissez le nom de la base de données que vous souhaitez utiliser pour l’IAA.

  3. Nom de schéma : Saisissez le nom du schéma que vous souhaitez utiliser pour l’IAA.

  4. Nom de l’entrepôt : Saisissez le nom de l’entrepôt en cours d’exécution dans votre compte Snowflake.

Enregistrez les modifications dans le fichier `iaa_config.toml`.

Avertissement

Avertissement : La cellule qui valide les entrées de connexion peut échouer si les informations .toml sont erronées ; dans ce cas, vérifiez les informations d’entrée.

Noyau

Pour exécuter le fichier .ipynb, vous devez installer les extensions Python et Jupyter dans VS Code.#x20;

  1. Sélectionnez l’environnement python conforme à la version requise pour exécuter le notebook. (3.11 ou supérieure).#x20;

Exécution du notebook

Pour déployer l’application dans votre compte Snowflake, veuillez sélectionner « Exécuter toutes les cellules ».

Ces cellules configurent automatiquement l’environnement local et établissent la connexion à votre compte Snowflake pour préparer le déploiement de l’application Streamlit. Plus précisément, ces cellules permettront de :

  1. Vérifier l’exigence Python3.11

  2. Vérifier l’exigence Snowflake CLI

  3. Exécuter le fichier iaa_config.toml pour vous connecter à la configuration du compte Snowflake :

    1. Lire le fichier .toml local

    2. Valider les entrées de connexion

    3. Établir une connexion avec Snowflake

  4. Préparer l’environnement pour déployer l’application Streamlit dans Snowflake

    1. Configurer l’environnement local

    2. Récupérer les entrées de connexion

  5. Déployer l’application Streamlit dans Snowflake à l’aide de Snowflake CLI :

    1. Déployer le schéma de l’application sur SiS.

    2. Déployer la zone de préparation Maps sur SiS.

    3. Déployez l’APP sur SiS.

    4. Actualiser le déploiement

    5. Récupérez les informations de l’application et fournissez un bouton d’accès.

    \ Terminé ! Il est temps de charger votre sortie.

Il est temps de charger votre sortie SMA ! #x20;

Localisez le fichier zip SMA de sortie, nommé selon le format “AssessmentFiles_*.zip”, dans le dossier de sortie.

  1. Accédez à votre compte Snowflake.

Data > Databases > [Your IAA Database] > Stages > SMA_EXECUTIONS
Copy

![Zone de préparation SMA_EXECUTIONS dans votre compte Snowflake.](/images/ migrations/sma-assets/explore_executions_upload_sma_output.png)

  1. Chargez votre AssessmentFiles.zip.#20 ;

Chargement de la sortie SMA dans la zone de préparationSMA_EXECUTIONS

  1. Ouvrir l’IAA pour explorer vos informations d’exécution. Cette étape peut prendre environ 30 secondes.#x20;

IAA

  1. Une fois ouverte, la page d’accueil de l’IAA ressemblera à ceci :#20;

Page d’accueil de l’IAA

Vous pouvez maintenant explorer votre exécution en utilisant l’IAA.

Exploration de l’IAA

L’application d’évaluation interactive (IAA) est maintenant installée dans votre compte Snowflake. Vous avez chargé correctement vos exécutions de sortie SMA et êtes prêt à explorer la compatibilité de votre code Spark avec Snowpark.#x20;

Note

Rappelez-vous comment accéder à l’IAA dans votre compte Snowflake :

Projets > Streamlit > Application d'évaluation interactive

L’IAA vous permettra d’identifier quelles parties de votre code sont directement compatibles et quelles parties nécessitent une intervention manuelle ou une optimisation supplémentaire. Il est recommandé d’utiliser la dernière version de SMA Toutefois, si vous avez des exécutions plus anciennes, l’IAA les comparera aux dernières versions de mappage de l’API.

Langage: Français