SnowConvert: Relatórios¶

Glossário¶

Nesta seção, tentamos explicar os conceitos usados em vários documentos de relatório gerados pelo SnowConvert.

Total de problemas de conversão, a contagem total de problemas de conversão que ocorreram durante o processo de conversão. Um problema de conversão é um erro ocorrido durante o processo de conversão relacionado a E/S de arquivos, gerenciamento de memória ou qualquer situação anormal que não pôde ser tratada. Essas são exceções de código não tratadas e são consideradas problemas críticos.
Total de erros de análise, a contagem total de erros de análise que ocorreram durante o processo de análise de código. Um erro de análise ocorre quando o analisador (o componente que lê 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 corresponde à especificação da gramática SQL que o analisador estava esperando. Em outros casos, esses erros também podem ocorrer porque o analisador ainda não está pronto para suportar uma gramática específica. Os erros de análise também são considerados problemas críticos. Se esse número for alto em relação ao tamanho da carga de trabalho de migração, é recomendável revisar o código de entrada.
Total de avisos, a contagem total de avisos que o SnowConvert gerou para a entrada fornecida. Um aviso é inserido quando a conversão de um elemento específico é, na maioria das vezes, funcionalmente equivalente, mas há alguns casos extremos em que pode ser necessária alguma intervenção do usuário. Eles têm baixa gravidade porque sua intenção é fornecer informações que possam ser revisadas se o código mostrar algum tipo de diferença funcional quando executado na plataforma de destino.
Total de linhas de código (LOC), o número total de linhas no texto dos arquivos de código-fonte, que não são comentários ou linhas em branco, que foram processadas pela ferramenta de conversão.
Objetos Identificados, em geral, referem-se a TABLES, VIEWS e PROCEDURES. Esses objetos são classificados como de nível superior porque geralmente são os elementos «raiz» de um DDL de dialeto de banco de dados, e podem conter outras definições «menores». Os objetos de nível superior variam de um dialeto SQL para outro (Oracle, Teradata, SqlServer, etc.). Para obter mais informações sobre os objetos de nível superior em cada dialeto SQL suportado pelo SnowConvert, você pode consultar este link em nossa documentação. Erros de análise podem fazer com que o SnowConvert não consiga contar corretamente todos os objetos de nível superior.
Elementos não reconhecidos, qualquer elemento de código (ou partes dele), como DML, DDL, instruções de controle, com erros de análise que o SnowConvert 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 o SnowConvert não foi capaz de processar.
Objetos totalmente convertidos, a contagem de objetos de nível superior que foram totalmente convertidos sem nenhum erro em nenhuma de suas subpartes. Eles são considerados prontos para a implantação.
Taxa de conversão de código (SQL), essa métrica é calculada usando como referência o código-fonte dos elementos reconhecidos e não reconhecidos na carga de trabalho fornecida. A taxa de conversão é a porcentagem do código-fonte que foi convertido com êxito pelo SnowConvert em código Snowflake funcionalmente equivalente. Leve em consideração que os 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, os elementos que não têm equivalência no Snowflake também prejudicam a taxa de conversão, pois, embora o SnowConvert consiga processá-los (frequentemente removendo-os ou comentando-os), a conversão não representa um código funcionalmente equivalente. Por exemplo, se houver muito código de índices (que não têm um equivalente no Snowflake), a taxa de conversão pode ser altamente penalizada porque o código-fonte desses elementos sem suporte pode representar uma parte significativa da carga de trabalho geral.
Taxa de conversão de objetos, a porcentagem entre objetos totalmente convertidos e objetos identificados.

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

O relatório HTML fornece uma visão geral dos resultados da transformação. Essa documentação fornecerá um guia sobre como ler o conteúdo do relatório.

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.