Snowpark Migration Accelerator: Entendendo o resumo da avaliação¶

Pontuação de preparação do Spark API¶

Esse relatório inclui vários itens, sendo a pontuação de preparação a métrica mais importante.

Vamos examinar cada seção em detalhes:

1. Pontuação de preparação - A Pontuação de preparação do Spark API é a principal métrica que o SMA usa para avaliar a preparação do seu código para a migração. Essa pontuação representa a porcentagem de referências do Spark API que podem ser convertidas para o Snowpark API. Embora essa pontuação seja útil, ela considera apenas as referências do Spark API e não leva em conta as bibliotecas de terceiros ou outros fatores. Portanto, use-a como uma avaliação inicial em vez de uma avaliação completa.

   A pontuação é calculada dividindo-se o número de referências conversíveis do Spark API pelo número total de referências do Spark API encontradas em seu código. Por exemplo, se a pontuação mostrar 3541/3746, isso significa que 3541 referências podem ser convertidas de um total de 3746 referências. Uma pontuação mais alta indica melhor compatibilidade com o Snowpark API. Você pode encontrar essa pontuação na primeira página do relatório detalhado.

2. Sugestão sobre o que fazer em seguida - Com base em sua pontuação de preparação, o SMA fornece recomendações para as próximas etapas do processo de migração.

3. Explicação da pontuação de preparação - Esta seção fornece detalhes sobre o significado da pontuação de preparação do Spark API e como interpretar os resultados.

4. Detalhes da pontuação de preparação - Esta seção mostra como a sua pontuação foi calculada usando duas métricas principais:

   • Usos prontos para conversão: O número de referências Spark API (funções, elementos ou instruções de importação) que podem ser convertidas para o Snowpark

   • Usos identificados: O número total de referências Spark API encontradas em seu código

Pontuação de preparação das bibliotecas de terceiros¶

A pontuação de preparação das bibliotecas de terceiros será exibida no seguinte formato:

1. Pontuação de preparação - Exibe sua pontuação de preparação e sua categoria (verde, amarela ou vermelha). A pontuação de preparação das bibliotecas de terceiros mostra a porcentagem das bibliotecas importadas que são compatíveis com o Snowflake. Para obter mais detalhes, consulte a seção [Pontuação de preparação de API de terceiros] (readiness-scores.md#third-party-api-readiness-score).

2. Próximos passos - Com base em sua pontuação de preparação, o SMA fornece recomendações para suas próximas ações.

3. Explicação da pontuação - Descreve o que significa a pontuação de preparação das bibliotecas de terceiros e como interpretar seus resultados.

4. Detalhes da pontuação - Mostra como a pontuação de preparação das bibliotecas de terceiros foi calculada usando esta fórmula: (Número de chamadas de biblioteca suportadas no Snowpark) ÷ (Número total de chamadas de biblioteca identificadas)

   Onde:

   • «Chamadas de biblioteca compatíveis com o Snowpark» significa as bibliotecas que o Snowpark pode usar

   • «Chamadas de biblioteca identificadas» significa todas as chamadas de biblioteca de terceiros encontradas em seu código, incluindo bibliotecas Spark e não Spark, sejam elas suportadas ou não

Pontuação de preparação de SQL¶

A Pontuação de preparação de SQL será exibida no seguinte formato:

• Pontuação de preparação - Exibe sua pontuação de preparação e sua categoria (verde, amarela ou vermelha). Essa pontuação indica quantos elementos SQL em seu código podem ser convertidos com sucesso para o Snowflake SQL. Para obter mais detalhes, consulte a seção Pontuação de preparação de SQL.

• Próximas etapas - Com base em sua pontuação de preparação, o SMA fornece recomendações de ações a serem tomadas antes de prosseguir.

• Score Explanation - Fornece uma explicação clara da pontuação de preparação de SQL e como interpretar seus resultados.

• Score Breakdown - Mostra um cálculo detalhado da sua Pontuação de preparação de SQL, calculada como: (número de elementos suportados) ÷ (número total de elementos).

Usos do Spark API¶

O relatório contém três seções principais exibidas como guias:

1. Classificação de uso geral

2. Categorização do uso do Spark API

3. Usos do Spark API por status

Examinaremos cada seção em detalhes a seguir.

Chamadas de importação¶

A seção «Import Calls» exibe as importações de bibliotecas externas usadas com frequência encontradas em sua base de código. Observe que as importações do Spark API estão excluídas desta seção, pois são abordadas separadamente na seção «Spark API «.

Essa tabela contém as seguintes informações:

O relatório exibe as seguintes informações:

1. Uma tabela com 5 linhas exibidas:

   • As 3 bibliotecas Python importadas com mais frequência

   • Uma linha «Other» resumindo todos os pacotes restantes

   • Uma linha «Total» mostrando a soma de todas as importações

2. Uma coluna «Supported in Snowpark» indicando se cada biblioteca está incluída na lista de pacotes no Snowpark suportados pelo Snowflake.

3. Uma coluna «Import Count» mostra quantas vezes cada biblioteca foi importada em todos os arquivos.

4. Uma coluna «File Coverage» mostra a porcentagem de arquivos que contêm pelo menos uma importação de cada biblioteca. Por exemplo:

   • Se “sys” aparecer 29 vezes nos comandos de importação, mas for usado apenas em 28,16% dos arquivos, isso sugere que ele é normalmente importado uma vez por arquivo em que é usado.

   • A categoria «Other» poderia mostrar 56 importações que ocorrem em 100% dos arquivos.

Para obter informações detalhadas sobre a importação por arquivo, consulte o arquivo ImportUsagesInventory.csv nos relatórios de saída.

Resumo do arquivo¶

O relatório resumido contém várias tabelas que exibem métricas organizadas por tipo e tamanho de arquivo. Essas métricas fornecem informações sobre o volume da base de código e ajudam a estimar o esforço necessário para o projeto de migração.

O Snowpark Migration Accelerator analisa todos os arquivos em sua base de código-fonte, incluindo arquivos de código e não-código. Você pode encontrar informações detalhadas sobre os arquivos verificados no relatório files.csv.

O Resumo do arquivo contém várias seções. Vamos examinar cada seção em detalhes.

Resumo dos problemas¶

O Resumo de problemas fornece informações críticas sobre possíveis problemas encontrados durante a verificação de código. Ao fazer a transição da avaliação para a conversão, você verá uma lista de EWIs (Errors, Warnings, and Issues) detectados em sua base de código. Para obter uma explicação detalhada desses problemas, consulte a seção Análise de problemas na documentação.

Na parte superior do resumo de problemas, vocês encontrará uma tabela que fornece uma visão geral de todos os problemas identificados.

A tabela contém duas linhas.

• O «Número de problemas» representa a contagem total de todos os códigos de problemas encontrados em cada categoria.

• O «Número de problemas exclusivos» representa a contagem de códigos de erro distintos encontrados em cada categoria.

Os problemas são divididos em três categorias principais:

• Avisos indicam possíveis diferenças entre as plataformas de origem e de destino que podem não exigir ação imediata, mas devem ser consideradas durante o teste. Isso pode incluir pequenas variações de comportamento para casos extremos ou notificações sobre alterações na aparência em comparação com a plataforma de origem.

• Problemas de conversão destaca os elementos que não foram convertidos ou que precisam de configuração adicional para funcionar corretamente na plataforma de destino.

• Problemas de análise ocorrem quando a ferramenta não consegue interpretar elementos de código específicos. Esses são problemas críticos que exigem atenção imediata, geralmente causados por código-fonte que não está sendo compilado ou por extração incorreta de código. Se acreditar que seu código-fonte está correto, mas ainda recebe erros de análise, isso pode ser devido a um padrão não reconhecido no SMA. Nesses casos, acesse relatar um problema e inclua a seção do código-fonte problemático.

A tabela resume a contagem total de cada item.

Abaixo dessa tabela, você encontrará uma lista de códigos de problema exclusivos e suas descrições.

Cada entrada de código de problema fornece:

• O identificador exclusivo do problema

• Uma descrição do problema

• O número de ocorrências

• O nível de gravidade (Warning, Conversion Error ou Parsing Error)

Você pode clicar em qualquer código de problema para visualizar a documentação detalhada que inclui:

• Uma descrição completa do problema

• Exemplo de código

• Soluções recomendadas

Por exemplo, ao clicar no primeiro código de problema mostrado acima (SPRKPY1002 ), você será direcionado para a página de documentação dedicada.

Por padrão, a tabela exibe apenas os 5 principais problemas. Para visualizar todos os problemas, clique no botão SHOW ALL ISSUES localizado abaixo da tabela. Você também pode usar a barra de pesquisa acima da tabela para encontrar problemas específicos.

Entender o trabalho de conversão restante é crucial durante o modo de avaliação. Você pode encontrar informações detalhadas sobre cada problema e sua localização no inventário de problemas na pasta Reports.

Resumo da execução¶

O resumo da execução fornece uma visão geral abrangente da análise recente da ferramenta. Isso inclui:

• A pontuação da análise de código

• Detalhes do usuário

• A ID de execução exclusiva

• Informações sobre a versão do SMA e do Snowpark API

• Locais da pasta do projeto que foram especificados durante a criação do projeto

Apêndices¶

Os apêndices contêm informações de referência adicionais que podem ajudá-lo a entender melhor a saída gerada pela ferramenta SMA.

Este guia contém informações gerais de referência sobre o uso do Snowpark Migration Accelerator (SMA). Embora o conteúdo possa ser atualizado periodicamente, ele se concentra no uso universal do SMA em vez de detalhes sobre bases de código específicas.

Isso é o que a maioria dos usuários verá ao executar o Snowpark Migration Accelerator (SMA). Se estiver usando uma versão mais antiga, você poderá ver o Resumo abreviado da avaliação, que é mostrado abaixo.