SnowConvert : 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.

Nombre total des problèmes de conversion : nombre total de problèmes de conversion survenus au cours du processus de conversion. Un problème de conversion est une erreur qui s’est produite au cours du processus de conversion et qui est liée aux entrées/sorties de fichiers, à la gestion de la mémoire ou à toute autre situation anormale qui n’a pas pu être gérée. Il s’agit d’exceptions de code non gérées et considérées comme des problèmes critiques.
Nombre total des erreurs d’analyse : 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 les fichiers de code source) rencontre un événement inattendu. Il s’agit généralement d’une erreur de syntaxe, c’est-à-dire d’un élément de code dans le fichier qui ne correspond pas à la spécification grammaticale SQL attendue par l’analyseur. Dans d’autres cas, ces erreurs peuvent également se produire car l’analyseur n’est pas encore prêt à prendre en charge une grammaire spécifique. Les erreurs d’analyse sont également considérées comme des problèmes critiques. Si ce nombre est élevé par rapport à la taille de la charge de travail de migration, une révision du code d’entrée est conseillée.
Nombre total d’avertissements : Nombre total d’avertissements générés par SnowConvert pour l’entrée donnée. Un avertissement est inséré lorsque la traduction d’un élément spécifique est pour l’essentiel équivalente sur le plan fonctionnel, mais qu’il existe quelques cas particuliers nécessitant l’intervention d’un utilisateur. Leur degré de gravité est faible, car leur but est de fournir des informations qui peuvent être examinées si le code présente une quelconque différence fonctionnelle lorsqu’il est exécuté sur la plateforme cible.
Nombre total de lignes de code (LOC) : Nombre total de lignes dans le texte des fichiers de code source, qui ne sont pas des commentaires ou des lignes vides, qui ont été traitées par l’outil de conversion.
Objets identifiés : En général, il s’agit de TABLES, de VIEWS et de PROCEDURES. Ces objets sont classés comme étant de niveau supérieur car ils sont généralement les éléments « racine » d’un DDL de dialecte de base de données, et qu’ils peuvent contenir d’autres définitions « plus petites ». Les objets de niveau supérieur varient d’un dialecte SQL à l’autre (Oracle, Teradata, SqlServer, etc.). Pour plus d’informations sur les objets de niveau supérieur dans chaque dialecte SQL pris en charge par SnowConvert, vous pouvez consulter ce lien dans notre documentation. Des erreurs d’analyse peuvent empêcher SnowConvert de compter correctement tous les objets de niveau supérieur.
Éléments non reconnus : tout élément de code (ou partie d’entre eux) tel que DML, DDL, les instructions de contrôle, avec des erreurs d’analyse que SnowConvert n’a pas été en mesure de traiter.
Lignes de code dans les éléments non reconnus : Nombre total de lignes de code dans tous les éléments non reconnus. C’est un bon indicateur de la quantité de code que SnowConvert n’a pas pu traiter.
Objets entièrement convertis : Nombre d’objets de niveau supérieur qui ont été entièrement convertis sans aucune erreur dans l’une de leurs sous-parties. Ils sont considérés comme prêts à être déployés.
Taux de conversion du code (SQL) : cette métrique est calculée en utilisant comme référence le code source des éléments reconnus et non reconnus dans la charge de travail donnée. Le taux de conversion est le pourcentage de code source qui a été converti avec succès par SnowConvert en code Snowflake équivalent sur le plan fonctionnel. Tenez compte du fait que les éléments non reconnus (en raison de problèmes d’analyse syntaxique) affecteront cette mesure, car leur code source sera considéré comme non converti. En outre, les éléments qui n’ont pas d’équivalence dans Snowflake pénaliseront également le taux de conversion, car même si SnowConvert est en mesure de les traiter (souvent en les supprimant ou en les commentant), la traduction ne représente pas un code équivalent sur le plan fonctionnel. Par exemple, s’il y a beaucoup de code d’index (qui n’ont pas d’équivalent dans Snowflake), le taux de conversion peut être fortement pénalisé parce que le code source de ces éléments non pris en charge peut représenter une part importante de la charge de travail globale.
Taux de conversion des objets : pourcentage entre les objets entièrement convertis et les objets identifiés.

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 HTML¶

Le rapport HTML donne un aperçu général des résultats de la transformation. Cette documentation vous guidera dans la lecture du contenu du rapport.

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.