SnowConvert AI - Rapports¶
Glossaire¶
Dans cette section, nous essayons d’expliquer les concepts utilisés dans les multiples documents de rapport générés par SnowConvert.
Lignes de code (LOC : le nombre total de lignes dans le texte des fichiers de code source, à l’exclusion des lignes vides, qui ont été traitées par l’outil de conversion. Un commentaire est considéré comme une ligne de code.
Analyse des EWIs : le nombre total d’erreurs d’analyse qui se sont produites au cours du processus d’analyse du code. Une erreur d’analyse se produit lorsque l’analyseur (le composant qui lit et comprend les fichiers de code source) rencontre quelque chose d’inattendu. Cela signifie généralement une erreur de syntaxe, qui fait référence à un élément de code dans le fichier qui ne correspond pas à la spécification grammaticale SQL à laquelle l’analyseur s’attendait. Dans d’autres cas, ces erreurs peuvent également se produire parce que l’analyseur n’est pas encore prêt à prendre en charge une grammaire spécifique. Les erreurs d’analyse sont considérées comme des problèmes critiques, car si le code n’est pas analysé, SnowConvert AI ne peut pas l’évaluer ou le traduire. Si ce nombre est élevé par rapport à la taille de la charge de travail de la migration, une révision du code d’entrée est conseillée.
Éléments non reconnus : tout élément de code (ou une partie de ceux-ci) tel que DML, DDL et les instructions de contrôle, avec des erreurs d’analyse que SnowConvert AI n’a pas pu traiter.
Lignes de code dans des éléments non reconnus : les lignes de code totales dans tous les éléments non reconnus. C’est un bon indicateur de la quantité de code que SnowConvert AI n’a pas pu traiter.
Unités de code (niveau supérieur) : une unité de code est l’élément exécutable le plus atomique et le plus autonome. Dans la plupart des cas, il s’agit d’instructions (comme DDL ou DML), mais elles incluent aussi des fichiers de script, car ceux-ci sont exécutés comme un seul élément. Elles sont classées comme de niveau supérieur parce qu’elles sont généralement les éléments « racine » d’un dialecte de base de données, et elles peuvent contenir d’autres définitions « plus petites ». Les unités de code de niveau supérieur varient d’un dialecte SQL vers un autre (Oracle, Teradata, SQL Server, etc.). Les erreurs d’analyse peuvent empêcher SnowConvert AI de compter correctement toutes les unités de code de niveau supérieur.
Taux de conversion des lignes de code : le pourcentage de lignes de code qui ont été converties correctement par SnowConvert AI dans le code Snowflake. Tenez compte du fait que les éléments non reconnus (en raison des problèmes d’analyse) affecteront cette métrique, car leur code source sera compté comme non converti. De plus, une conversion d’élément réussie peut ne pas être complètement équivalente dans Snowflake en raison de différences ou de limitations de plateforme. Dans ces cas, alors que le taux de conversion n’est pas corrigé, SnowConvert AI générera un FDM pour alerter sur une éventuelle différence de fonctionnalité. Un taux de conversion de 90 % pour une unité de code signifie que seulement 10 % de ses lignes de code n’ont pas été converties, et par conséquent, des EWIs sont générés pour elles.
Unités de code entièrement converties : le pourcentage d’unités de code de niveau supérieur qui ont été entièrement converties sans aucune erreur dans l’une de leurs sous-parties. Elles sont considérées comme prêtes à être déployées. Toute unité de code dont le taux de conversion est inférieur à 100 % n’est pas comptabilisée comme entièrement convertie.
Rapport d’évaluation (docx)¶
Le rapport d’évaluation est un document qui résume l’estimation du taux de conversion du code, ainsi que de nombreuses autres informations utiles permettant à l’utilisateur d’évaluer la distance qui le sépare de l’obtention d’un code Snowflake équivalent fonctionnel.
Rapport sur les unités de code de niveau supérieur¶
Le rapport sur les unités de code de niveau supérieur fournit un aperçu général des principaux objets présents dans votre code source. Ces objets de niveau supérieur contiennent des informations utiles sur l’état de la conversion et peuvent être utilisés pour prendre des décisions sur les étapes à suivre après la conversion.
[Rapport sur les problèmes] (issues-report.md)¶
Le rapport sur les problèmes est un fichier contenant des informations sur tous les problèmes survenus au cours du processus de migration.
Rapport sur les éléments¶
Le rapport sur les éléments présente une synthèse des éléments de grammaire trouvés au cours du processus de migration. Le résumé est effectué sur la base de plusieurs colonnes, ce qui permet de distinguer les mêmes éléments de grammaire s’ils appartiennent à des contextes différents. Par exemple, une requête SELECT peut faire partie d’une PROCEDURE, ou d’une VIEW, ou même se trouver dans un fichier de script. Grâce à ce rapport, vous devriez être en mesure de voir les éléments avec une certaine nuance et d’examiner leur statut de transformation global.
Rapport sur l’utilisation des fonctions¶
Le rapport sur l’utilisation des fonctions résume les appels des fonctions intégrées et définies par l’utilisateur trouvées au cours du processus de conversion, regroupées en fonction de leur statut de migration. Ce rapport permet à l’utilisateur d’obtenir des détails sur les utilisations des fonctions, si elles ont été transformées en fonctions Snowflake sans problème, ou si elles nécessitent une action supplémentaire après la conversion.
ETL Replatform Issues Report¶
The ETL Replatform Issues Report (EWIs Report) provides a detailed inventory of errors, warnings, and issues encountered during SSIS to dbt migration. Use this report to identify ETL components that require manual intervention or review.
ETL Replatform Component Summary Report¶
The ETL Replatform Component Summary Report provides a comprehensive inventory of all identified SSIS components and their migration outcomes. Use this report to understand the overall ETL migration scope and identify areas requiring attention.