SnowConvert : Rapport sur les éléments

Qu’est-ce qu’un « élément » ?

Le terme « élément » est utilisé dans ce contexte pour désigner un élément de grammaire, c’est-à-dire un élément d’une grammaire qui a un nom, une syntaxe et une fonction dans un langage spécifique.

En général, ces éléments sont mis en évidence et revêtent une grande importance dans la documentation d’un langage.

Voici quelques exemples d’éléments dans les langages SQL :

  • Tout DDL, tel que CREATE TABLE et CREATE VIEW

  • Contenu important de DML, tel que PARTITION BY et NOT NULL

  • Tout DML, comme INSERT et DELETE

  • Certaines expressions importantes, telles que IN, NOT IN, BETWEEN et LIKE

  • Opérateurs, y compris les opérateurs conditionnels et arithmétiques

  • Certaines parties internes des requêtes, telles que ORDER BY, WHEN, INNER JOIN et TOP.

  • Des fonctions importantes, telles que AVG et RANK

Essentiellement, tout ce qui mérite d’être suivi à des fins d’évaluation peut être considéré comme un élément.

Où puis-je le trouver ?

Le rapport sur les éléments se trouve dans un dossier nommé « reports », dans le dossier de sortie de votre conversion. Le nom du fichier lui-même commence par « Elements », ce qui permet de le localiser facilement.

Le format du fichier est le suivant : .CSV.

Quelles informations contient-il ?

Le rapport sur les éléments est présenté sous forme de table et contient les colonnes suivantes :

ColumnDescription
SessionIDThe session ID of the transformation. This is a unique identifier for the transformation session.
CategoryThe element's corresponding category. These can be DDL, DDL Content, DML, Functions & Expressions, Statement, Query, and so on.
Grammar ElementThe name associated to the element, often the same as found in the official documentation for the language.
File TypeThe type of the file that contains the element. For example: SQL.
Total CountThe total count of that particular element found during the transformation process.
Not Converted Count (Self)The count of that particular element that presented issues severe enough for it to not properly transform. Usually unsupported structures or elements that had a particular transformation error.
Keep in mind that "Self" means that some of the inner contents of the element may or may not be not converted, but if the element itself did not present errors, it will not be counted towards this column.

Synthétisation

Chaque élément individuel est résumé à l’aide d’un critère spécifique, qui peut inclure plusieurs colonnes pour former une « clé composite ». Le groupement de base est constitué des colonnes Catégorie, Élément de grammaire et Type de fichier.

Selon cette convention, le même élément SELECT pourrait être résumé différemment selon le type du fichier qui le contient, ou deux éléments qui partagent le même élément de grammaire (ou nom) peuvent encore être résumés indépendamment si leur catégorie est différente.

Langage: Français