SnowConvert AI – Berichte¶

Glossar¶

In diesem Abschnitt versuchen wir, die Konzepte zu erklären, die in den von SnowConvert erstellten Berichten verwendet werden.

• Codezeilen (LOC): die Gesamtzahl der Zeilen im Text der Quellcodedateien, ohne Leerzeilen, die vom Konvertierungstool verarbeitet wurden. Ein Kommentar wird als eine Codezeile betrachtet.

• Parsen von EWIs: Gesamtzahl der Parsing-Fehler, die während des Codeanalyseprozesses aufgetreten sind. Ein Parsing-Fehler tritt auf, wenn der Parser (die Komponente, die die Quellcodedateien liest und versteht) auf etwas Unerwartetes stößt. Dies bedeutet in der Regel einen Syntaxfehler, der sich auf ein Codeelement in der Datei bezieht, das nicht der grammatikalischen SQL-Spezifikation entspricht, die der Parser erwartet hat. In anderen Fällen können diese Fehler auch auftreten, weil der Parser noch nicht bereit ist, eine bestimmte grammatikalische Spezifikation zu unterstützen. Parsing-Fehler gelten aus folgendem Grund als kritische Probleme: Wenn der Code nicht geparst wird, kann er von SnowConvert AI nicht bewertet oder übersetzt werden. Wenn diese Zahl im Verhältnis zum Umfang des Migrationsworkloads hoch ist, wird eine Überarbeitung des Eingabecodes empfohlen.

• Nicht erkannte Elemente: jedes Codeelement (oder Teile davon) wie z. B. DML, DDL, Steuerungsanweisungen mit Parsing-Fehlern, die SnowConvert AI nicht verarbeiten konnte.

• Codezeilen in nicht erkannten Elementen: Gesamtzahl der Codezeilen in allen nicht erkannten Elementen. Dies ist ein guter Indikator dafür, wie viel Code SnowConvert AI nicht verarbeiten konnte.

• Codeeinheiten (oberste Ebene): Eine Codeeinheit ist das atomarste, eigenständigste ausführbare Element. In den meisten Fällen handelt es sich dabei um Anweisungen (wie DDL oder DML). Sie enthalten aber auch Skriptdateien, da diese als ein einzelnes Element ausgeführt werden. Sie werden als „der obersten Ebene“ klassifiziert, da sie normalerweise die „Stammelemente“ für einen Datenbankdialekt sind und andere „kleinere“ Definitionen enthalten können. Codeeinheiten der obersten Ebene variieren zwischen den verschiedenen SQL-Dialekten (Oracle, Teradata, SQL Server usw.). Parsing-Fehler können dazu führen, dass SnowConvert AI nicht in der Lage ist, alle Codeeinheiten der obersten Ebene korrekt zu zählen.

• Zeilen der Codezeilenkonvertierungsrate: Der Prozentsatz der Codezeilen, die erfolgreich von SnowConvert AI in Snowflake-Code konvertiert wurden. Beachten Sie, dass nicht erkannte Elemente (aufgrund von Parsing-Problemen) diese Metrik beeinflussen, da ihr Quellcode als nicht konvertiert gezählt wird. Darüber hinaus ist eine erfolgreiche Elementkonvertierung aufgrund von Plattformunterschieden oder Einschränkungen in Snowflake möglicherweise nicht vollständig gleichwertig. In solchen Fällen wird die Konvertierungsrate zwar nicht beeinträchtigt, SnowConvert AI generiert jedoch eine FDM, um auf die mögliche Funktionsunterschiede hinzuweisen. Eine Konvertierungsrate von 90 % für eine Codeeinheit bedeutet, dass nur 10 % der Codezeilen nicht konvertiert wurden. Deshalb werden EWIs für sie generiert.

• Vollständig konvertierte Codeeinheiten: Prozentsatz der Codeeinheiten der obersten Ebene, die vollständig konvertiert wurden, ohne dass in einem ihrer Teile Fehler auftraten. Sie gelten als bereit für die Bereitstellung. Jede Codeeinheit, deren Konvertierungsrate weniger als 100 % beträgt, wird nicht als vollständig konvertiert angesehen.

Bewertungsbericht (.docx)¶

Der Bewertungsbericht ist ein Dokument, das die Schätzung der Codekonvertierungsrate und viele weitere nützliche Informationen für den Benutzer zusammenfasst, damit er abschätzen kann, wie weit er auf dem Weg zu einem funktional gleichwertigen Snowflake-Code ist.

Top-Level Code Units Report¶

Der Top-Level Code Units Report bietet einen allgemeinen Überblick über die wichtigsten Objekte in Ihrem Quellcode. Diese Objekte der obersten Ebene enthalten nützliche Informationen über den Status der Konvertierung und können verwendet werden, um Entscheidungen über die nächsten Schritte nach der Konvertierung zu treffen.˚

Problembericht¶

Der Problembericht ist eine Datei, die Informationen über alle Probleme enthält, die während des Migrationsprozesses aufgetreten sind.

Elementbericht¶

Der Elementbericht zeigt eine zusammengefasste Anzahl der Grammatikelemente, die während des Migrationsprozesses gefunden wurden. Die Zusammenfassung erfolgt in mehreren Spalten, sodass eine Unterscheidung zwischen denselben Grammatikelementen möglich ist, wenn sie in verschiedene Kontexte gehören. Eine SELECT-Abfrage kann zum Beispiel Teil einer PROCEDURE oder einer VIEW sein oder sogar in einer Skriptdatei stehen. Mithilfe dieses Berichts sollten Sie die Elemente nuanciert betrachten und ihren allgemeinen Transformationsstatus überprüfen können.

Bericht zur Funktionsverwendung¶

Der Bericht zur Funktionsverwendung fasst die Aufrufe von integrierten und benutzerdefinierten Funktionen zusammen, die während des Konvertierungsprozesses gefunden wurden. Sie werden nach ihrem Migrationsstatus gruppiert. Mit diesem Bericht können Benutzende Details zur Verwendung von Funktionen abrufen und erfahren, ob sie problemlos in Snowflake konvertiert wurden oder ob sie nach der Konvertierung eine zusätzliche Aktion erfordern.

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.