SnowConvert AI - Relatórios¶
Glossário¶
Nesta seção, tentamos explicar os conceitos usados em vários documentos de relatório gerados pelo SnowConvert.
Linhas de código (LOC): o número total de linhas no texto dos arquivos de código-fonte, excluindo as linhas em branco, que foram processadas pela ferramenta de conversão. Um comentário é considerado uma linha de código.
Análise de EWIs: a contagem total de erros de análise que ocorreram durante o processo de análise do código. Um erro de análise ocorre quando o analisador (o componente que lê e entende os arquivos de código-fonte) encontra algo inesperado. Isso geralmente significa um erro de sintaxe, que se refere a um elemento de código no arquivo que não correspondia à especificação da sintaxe SQL que o analisador estava esperando. Em outros casos, esses erros também podem ocorrer porque o analisador ainda não está pronto para oferecer suporte a uma sintaxe específica. Erros de análise são considerados problemas críticos porque, se o código não for analisado, SnowConvert AI não pode avaliá-lo ou traduzi-lo. Se esse número for alto em relação ao tamanho da carga de trabalho da migração, é recomendável revisar o código de entrada.
Elementos não reconhecidos: qualquer elemento de código (ou partes deles), como DML, DDL, instruções de controle, com erros de análise que o SnowConvert AI não conseguiu processar.
Linhas de código em elementos não reconhecidos: o total de linhas de código em todos os elementos não reconhecidos. Esse é um bom indicador de quanto código do SnowConvert AI não conseguiu processar.
Unidades de código (nível superior): uma unidade de código é o elemento executável mais atômico e independente. Na maioria dos casos, estas são instruções (como DDL ou DML), mas também incluem arquivos de script porque esses são executados como um único elemento. Elas são classificadas como de nível superior porque geralmente são os elementos “raiz” de um dialeto de banco de dados e podem conter outras definições “menores”. As unidades de código de nível superior variam de um dialeto do SQL para outro (Oracle, Teradata, SQL Server etc.). Erros de análise podem fazer o SnowConvert AI não conseguir contar corretamente todas as unidades de código de nível superior.
Taxa de conversão de linhas de código: a porcentagem de linhas de código que foram convertidas com sucesso pelo SnowConvert AI em código do Snowflake. Leve em consideração que elementos não reconhecidos (devido a problemas de análise) afetarão essa métrica, pois seu código-fonte será contado como não convertido. Além disso, uma conversão de elemento bem-sucedida pode não ser totalmente equivalente no Snowflake devido a diferenças ou limitações da plataforma. Nesses casos, enquanto a taxa de conversão não é penalizada, o SnowConvert AI gera um FDM para alertar sobre a possível diferença na funcionalidade. Uma taxa de conversão de 90% para uma unidade de código significa que apenas 10% de suas linhas de código não foram convertidas e, portanto, EWIs são gerados para elas.
Unidades de código totalmente convertidas: a porcentagem de unidades de código de nível superior que foram totalmente convertidas sem nenhum erro em nenhuma de suas subpartes. Eles são considerados prontos para implantação. Qualquer unidade de código cuja taxa de conversão seja inferior a 100% não é contada como totalmente convertida.
Relatório de avaliação (docx)<!–TODO: Revisão..>¶
O relatório de avaliação é um documento que resume a estimativa da taxa de conversão de código e muitas outras informações úteis para o usuário estimar o quanto falta para obter um código do snowflake funcional equivalente.
[Relatório de unidade de código de nível superior] (top-level-code-units-report.md)¶
O relatório de unidade de código de nível superior fornece uma visão geral dos principais objetos presentes em seu código-fonte. Esses objetos de nível superior têm informações úteis sobre o estado da conversão e podem ser usados para tomar decisões sobre quais devem ser as próximas etapas após a conversão.˚
Relatório de problemas¶
O relatório de problemas é um arquivo que contém informações sobre todos os problemas que ocorreram durante o processo de migração.
Relatório de elementos¶
O relatório de Elementos mostra uma contagem resumida dos elementos gramaticais encontrados durante o processo de migração. O resumo é feito em uma base de várias colunas, portanto, há uma distinção entre os mesmos elementos gramaticais se eles pertencerem a contextos diferentes. Por exemplo, uma consulta SELECT pode fazer parte de um PROCEDURE, ou um VIEW, ou até mesmo estar em um arquivo de script. Usando esse relatório, você poderá ver os elementos com alguma nuance e analisar seu status geral de transformação.
Relatório de uso de funções¶
O relatório de uso de funções resume as invocações de funções internas e definidas pelo usuário encontradas durante o processo de conversão, agrupadas por seu status de migração. Este relatório permite que o usuário obtenha detalhes sobre os usos das funções, se eles foram transformados em código Snowflake sem problemas ou se exigem uma ação adicional após a conversão.
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.