SnowConvert AI - Assistant de migration - Prise en main¶

1. Install the Snowflake Visual Studio Code extension¶

Voir la documentation Snowflake sur l’installation à partir de la marketplace Visual Studio ou à partir d’un fichier .vsix.

Assurez-vous que vous utilisez la version GA 1.14.0 ou supérieure.

2. Sign in to Snowflake with the Visual Studio Code extension¶

Voir la documentation Snowflake sur comment se connecter à Snowflake avec l’extension VS Code.

3. Enable SnowConvert AI Migration Assistant in the Snowflake VS Code Extension Settings¶

Ouvrez le panneau des paramètres VS Code et accédez aux extensions. Sélectionnez l’extension Snowflake et ouvrez le panneau des paramètres de l’extension Snowflake.


.

Dans les paramètres de l’extension Snowflake, vous devez :

• Cocher « Activer l’assistant de migration SnowConvert AI »


4. Set up Model Preference¶

Pour plus d’informations sur la configuration de la préférence du modèle, veuillez consulter la documentation Préférence du modèle.

5. Open a workspace folder containing SnowConvert AI migration results¶

Tout d’abord, assurez-vous d’avoir un dossier d’espace de travail ouvert dans Visual Studio Code. Ensuite, accédez à l’extension Snowflake en sélectionnant son icône dans la barre d’activité à gauche. Un panneau « Problèmes SnowConvert AI » apparaîtra en bas de la vue de l’extension Snowflake. Ce panneau remplit automatiquement une liste de tous les dossiers et fichiers de l’espace de travail actuel qui ont des problèmes de migration SnowConvert AI. Si aucun espace de travail n’est sélectionné, le message suivant s’affiche sur le panneau des problèmes SnowConvert AI : « Aucun problème de migration SnowConvert AI détecté. »


Une fois que votre dossier d’espace de travail contenant les problèmes de migration SnowConvert AI est ouvert, vous pouvez accéder à la barre d’outils en survolant le panneau « Problèmes SnowConvert AI ». Cette barre d’outils située dans le coin supérieur gauche du panneau vous permet d’interagir avec la liste des problèmes de migration identifiés.

![Barre d’outils du panneau des problèmes SnowConvert AI](../../../images/migrations/sc-assets/MigrationAssistantSnowConvertIssuePanelToolbar.png « Barre d’outils du panneau des problèmes SnowConvert AI »

• 🏠 (Revenir à la racine de l’espace de travail) : Cliquer sur cette icône réinitialise la vue pour afficher l’état initial du dossier de l’espace de travail entier.

• 📁 (Sélectionner un dossier) : vous permet de naviguer vers un sous-dossier spécifique de votre espace de travail et de le sélectionner pour cibler la liste des problèmes.

• **🔄 (Actualiser les problèmes) : ** utilisez cette icône pour mettre à jour manuellement la liste des problèmes de migration SnowConvert AI. La liste sera également mise à jour automatiquement chaque fois qu’un problème sera résolu ou qu’un nouveau sera détecté.

• ➖ ( Tout réduire) : réduit tous les éléments développés de la liste de problèmes pour une vue plus compacte.

6 Consultez les problèmes de migration SnowConvert AI et cliquez sur les étincelles pour obtenir de l’aide sur la résolution de ces problèmes.¶

Une fois que vous aurez ouvert un dossier contenant des fichiers .sql avec des problèmes de migration, vous verrez une liste de tous les EWIs, FDMs, et PRFs dans ce dossier et dans les fichiers les contenant. Cliquer sur un problème de migration dans la liste dirige l’éditeur de code sur la ligne de code où le problème a été détecté.


Il existe deux façons d’obtenir une assistance alimentée par l’AIet des solutions recommandées pour un problème de migration :

1. Cliquez sur l’icône des étincelles à côté du problème de migration dans la liste.


2. Cliquez sur les CodeLenses identifié par _SnowConvert AI, qui se trouvent au-dessus de chaque problème de migration.


7 Obtenir de l’aide¶

Une fois que vous avez cliqué sur l’icône des étincelles ou sur les CodeLenses, l’assistant de migration SnowConvert AI interrogera Snowflake Cortex AI avec le problème de migration et un extrait du contexte du code entourant le problème de migration. L’appel à Cortex se fait entièrement dans votre compte Snowflake, avec les détails de connexion que vous avez configurés dans l’extension Snowflake. VS Code.

Une fois qu’un résultat aura été généré, il apparaîtra dans un panneau à droite de l’éditeur de code. Le résultat contiendra une explication du problème de migration dans le contexte de votre code et une suggestion de correctif pour que le code fonctionne correctement sur Snowflake. Si l’assistant n’est pas en mesure de générer une réponse avec un niveau de confiance élevé, il s’abstiendra de fournir une solution recommandée.


8. Interacting with the Migration Assistant¶

• Affiner les solutions : si une suggestion de l’AI est incorrecte ou vous préférez une approche différente, saisissez vos modifications ou instructions préférées dans la zone de chat.

• Poser une question en lien avec le SQL: si la suggestion est correcte, vous pouvez toujours demander des précisions ou des explications supplémentaires sur tout sujet associé au SQL.

• Modifications de code de requête : vous pouvez également demander des modifications de code spécifiques, telles que l’ajout d’un en-tête à votre script.

.